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Dilwyn Jones 


The latest developments on the QL 
scene include the new QPC, SMSQ/E 
3 and the Aurora "colour drivers’ from 
Marcel Kilgus. We have looked at some 
of these things in recent QL Todays 
and will be taking a further look at 
them in this issue. I've been using 
QPC2 v3.11 for a little while now and 
am very pleased with it. Although the 
new 256-colour mode SMSQ/E and 
GD2 for Aurora had not been released 
at the time of writing, QPC2 now has 
an Aurora-compatible 256 colour mode 
and very good It is too - I've been tes- 
ting some of my software on it and no 
problems (so far!) 

The next significant releases will pro- 
bably be the SOQL TCP/IP system and 
the Graphical User Interfaces. | was ve- 
ry pleased to hear that a SOQL based 
emailer is nearing completion, courtesy 
of Phoebus Dokos, and that the PPP 
protocol part of SOQL (in essence this 
brings us up to date for email) is work- 
ing. 

We've had previews of Jim Hunkins's 
QDT desktop system for SMSQ/E sys- 
tems in recent issues, and I've dropped 
the odd hint about the Launchpad sys- 
tem I've been developing over the last 
couple of years. In this issue, you will 
find a preview of Launchpad from a 
tester of the very first aloha-release - 
bugs, warts and all! | hope that the 
work Jim Hunkins and | have put into 
our respective GUls will bear fruit soon 
and that they wil be well received by 
the QL community, The QL has been 
one of the few computers not to have 
some form of GUI system, so hopefully 
this software will plug that gap. 


The QL shows scene looks like hotting 
up over the next year or so. AS we 
approach 20 years of the QL and 21 
years of Quanta next year (Quanta was 
established before the first QL was de- 
livered if | remember correctly, back in 
1983/84), the show calendar is starting 


to look pretty busy with shows current- 


ly planned in Ireland, Italy, Germany, The 
Netherlands, USA, and English shows 
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in Byfleet, Norwich, Manchester and 
Portslade in the planning stages for 
sometime over the next 12 months - 
keep reading our QL Show Agenda 
page for the latest news! There is a 
possibility that one of Quanta’s events 
will be a QL-2000 style of meeting to 
celebrate Quanta’s 2ist anniversary, 
hopefully this will be promoted as a 
major international meeting to bring 
QLers worldwide together to celebrate 
the 2ist year of Quanta’s existence. 


Do you have any ideas for a pro- 
gramme of events for such a meeting 
if it takes place? Do you think we 
should vote on a special award for the 
greatest contribution to the QL scene 
over the last 20 years or the greatest 
recent contribution? Do you think we 
should have an exhibition of QL histo- 
ry? Or try to invite notable QL 
luminaries from times past? Why not 
write in and let us know what you 
think! 

Who would have thought back in 1984 
when we were all worrying about QL 
delivery times and microdrive cartrid- 
ges that wouldn't read properly that 20 
years later we'd still be here and still 
this enthusiastic! 


it was completely fragmented! 


When he removed the drive from his 
QUBIDE the problem was obvious - 
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Quantum Leap Software 

Starting August 25th, Quantum Leap Software will 
have the first REAL QL books on sale in a long 
time, starting with a Hardware Reference Manual 
and Turbo's Reference manual. These will be 
available in either hardbound or spiral bound 
formats and due to the use of Print-On-Demand 
techniques any updates will be immediate. The 
books will be available to order only online (at 
least in the beginning). Also all books (and future 
titles) will be also available for free as PDF 
documents (downloadable). For more info contact 
Quantum Leap Software, 
941 Lilac Street #1, 
Indiana, 

PA 15701-3340 

USA 

email: ql@dokos-gr.net 


SOQL Emailer 

Phoebus Dokos writes: 

this quick note to tell you that the soQL-based 
emailer that | am writing is almost at the testing 
phase. Although it seems like a long time has 
passed since | announced the project, problems 
with C68, my month long holidays and school, 
made me devote very little time on it. However 
come summer session end in College | will be 
able to accelerate and hopefully by mid to end of 
August | will have it available for a beta test. 
Please note that this is a text only application 
using the SOQL TCP/IP system (Which means 
that whoever wants to write a WMAN front end 
to it is more than welcome) 


MidiPlayer/uQLx News 

Simon Goodwin writes: 

| have adapted Al Boehm's MIDI Player to run on 
UQLX, using any Unix/Linux supported MIDI 
device (€.g. virtually any PC sound card, and most 
flexible serial ports). The files are here (with Al's 
permission): 

http://simon.mooli.org.uk/QL/ 

It requires no commercial software other than 
‘Super’ Toolkit 2. 

Work on the SOUND device for UQLX continues. 
It is already a big superset of the Amiga/Q40 im- 
plementation. UQLX allows SOUND input as well 
as MIDI in... 


Web: www.dokos-gr.net 
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Javier Guerra writes: 

Hi again, these are two new links for the Spanish 
QL Forum and the new address of the Luna FTP 
Site: 

The Spanish QL Forum (QForum): 
http://boards.melodysoft.com/QFORUM/ 

The new address of the Luna FTP: 
ftp://ftp.gui.uva.es/pub/sinclair/ql/ 

Javier Guerra Sinclair QL Spanish Resources 
http://sinclairq|.info 


SourceEdit: SuperBasic syntax high- 


lighter for free... 

Jimmy Montesinos writes: 

For those who want to edit or print highlighted 
and colorized SuperBasic source code, Phoebus 
and | have released Superbasic language exten- 
sions for SourceEdit. 

SourceEdit website: 

http://www.sourceedit.com 

SourceEdit can be download at: 

http://www. brixoft.com/dload.asp 

SuperBasic language extension is at: 

http://www. brixoft.com/tnr.asp 

The author of SourceEdit explained to us how to 
handle a source code, you need: rename original 
SB file adding the extensions .qlbas for example, 
and then: 

Click Tools » Options and select the Files page. 
Click the Add Language button to add Super- 
Basic to the list and then select it from the drop- 
down. Type in *.qlbas in the Maps to Files textbox. 
To add it to the Open and Save As dialogs type 
SuperBasic as the description and *.qlbas as the 
extension in the lower frame and click Add. 

'm continuing to develop some tools in that same 
way... 


Phoebus Dokos adds: 

A new version of the language description file is 
out. It now includes 578 KEYWORDS plus other 
constructs and operators. Auto completion (with 
CTRL-SPACE) works pretty well. 

New version recognizes: 

All SBasic and SuperBasic keywords 

All QPC2 specific keywords 

All ROMDISQ specific keywords 

All (Super)Gold Card specific keywords 

All Turboloolkit Keywords 

All QLiberators runtime keywords 

Some Minerva Keywords 

All SuperHermes Keywords 

Thierry's CD Extensions Keywords 

Until it can be made available somewhere, please 
ask Phoebus or Jimmy for a copy. 
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Launchpad News 

| have set up a web page with information about 
and screen dumps from the Launchpad QL desk- 
top/GUI system. 

An alpha-test version of Launchpad is now out 
with a few testers, but currently has no manual 
and some of the little accessory programs are in- 
complete. | very much hope | will be able to, err, 
“Launch” the program at the Irish QL Show end of 
August (details of that and other shows on my 
website). 

The Launchpad website is at: 
http://homepages.tesco.net/dilwyn.jones/ 
launchpad/launchpad.htm! 


Menu Extension 

Well, it should have been ready some time ago 
(ike most other ‘colour’ updates) but various 
problems mentioned in the last two issues 
ensured that they are not quite ready yet. The 
software itself is actually ready for quite a while, 
but the documentation has not been updated yet. 
Roy Wood and J-M-S are trying hard to get all the 
updates out... and the new Menu Extension will be 
on most disks anyway. 

It is rather impossible to give a fixed date, as 
whenever there may be a bit of time, something 
negative happens... 


QPC2 V3.11 

This is now available from the usual QPC 
suppliers. Registered users can download up- 
dates from the author at 

www.kilgus.net 

~ the update is supplied as a zipped file which 
requires a password available to registered users 
to unpack the archive. 

QPC2 V3.10 and v3.11 includes SMSQ/E version 
3, and now boasts a new Aurora-compatible 256 
colour or 8-bit colour mode, some new parallel 
printer control extensions, command line options 
for QPC startup and fixes some minor problems 
with earlier versions. 


SMSQ/E & Keyboards 

As many of you know, SMSQ/E comes with 
builtin keyboard layouts for English, German, 
French and US-keyboards. Customers ask for 
other keyboard layouts, but we don't have any. 
As some layouts are tricky (non-spacing idents 
etc.) it is hard to produce them. If you have 
produced proper layout tables and you would like 
to share them with other SMSQ/E users by 
having them built into the system, then please 
contact Wolfgang Lenerz or Marcel Kilgus. 


WU 


JUST WORDS! 


And more to come... 


New in the Just Words! range, with more to come: 


VOCABULARY DATABASE - £5 or €7,50 


5,000 words in English, German, French, Dutch and Japanese. 


SCRABBLE LISTS - £1 or €1,50 


Two lists of Scrabble approved words. 


QTYP ENGLISH DICTIONARY - 194,000 words - £1 or €1,50 


Mixed UK and USA spellings 


QTYP ITALIAN DICTIONARY - 83,000 words - £1 or €1,50 
QTYP DUTCH DICTIONARY - 180,000 words - £1 or €1,50 


Corrected for 1995 spelling revision. 


QTYP GERMAN DICTIONARY - 165,000 words - £1 or €1.50 


Old spellings 


QTYP DANISH DICTIONARY - 23,000 words - £1 or €1,50 
QTYP NORWEGIAN DICTIONARY - 59,000 words - £1 or €1,50 


Geoff Wicks, 56 Peveril Crescent, West Hallam, Derbyshire DE7 6ND, U.K. 


Tel: +44 (0)115 - 930 3713 


email: gwicks@beeb.net 


Web: http://members.lycos.co.uk/geoffwicks/justwords.htm 
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Gee Graphics! (on the 
QL?) - Part 34 


H. L. Schaaf 


A Torricelli 3 point solution 
Form a triangle with the 3 points as vertices. 


If any vertex of the triangle has an angle equal to 
or greater than 120 degrees, then that vertex is 
the Torricelli point. 


This leaves the case where all vertices have 
angles less than 120 degrees. One method to 
solve this is to use a geometric construction: 


1 - construct an equilateral triangle on the 
outside of each leg of the triangle. 


2 - construct a line from each vertex of the 
triangle to the outer point of the equilateral 
triangle on the leg opposite 
that vertex. These "Simpson 
lines’ should all have equal 
length and that length is the 
same as the sum of the 
distances from the Torricelli 
point to the 3 points. 


3 - the common intersection of 
the 3 Simpson lines is the 
Torricelli point. 


The listing “Torricelli3_bas’ is inten- 
ded to show the solution graphi- 
cally. Options include reading from } 
DATA statements, letting the QL put 


100 REMark Torricel1i3_bas 
110 REMark H L Schaaf July 9, 2003 for GG#34 


in 3 points at random, or using the keyboard to 
enter the x and y coordinates for the three points. 


GG#24 ‘Circle packing’ QLloday Vol 6, Issue 3, 
Sept/October 2001 starting on page 38 has the 
FuNctions that need to be merged in. 


Next time, another way that lets the QL “hunt” for 
the answer 


Gauss's problem became known as the “Steiner” 
problem in 1941 due to a book "What is 
Mathematics’ by Richard Courant and Herbert 
Robbins which popularized the problem. The 
"Steiner tree’ problem for any number of points 
has been the subject of much research and con- 
jecture ever since. 


The 2nd edition of "What is Mathematics” was 
printed in 1969 with revisions by lan Stewart. The 
paperback version from Oxford University Press 
is ISBN 0-19-510519-2. 


120 REMark Torricelli 3 point solution using Simpson lines 


130: 

140 REMark window pixels, width and height 
150 WMON : 
160 Wp_wi% = 256 : Wp_hiZ = 202: 
170 graspix = 476/645 : IF VER$ = "JSU" : 
180 INK 7 :PAPER 2 : INK #2,0 :PAPER #2,4 


Wp_bo% = 1 


REMark 256x202a256x0 with border = 1 


graspix = 344/549 


190 REMark vertical and horizontal range per pixel for SCALE = 100 
200 V_rpp = 101/(Wp_hi%-2*Wp_bo%) : H.rpp = V_rpp*graspix 
210 Wg_wi = H_rpp * (Wp_wi%-4*Wp_bo%) : REMark window graphic width 


220 Wg_h2v = Wg_wi/i0l1 : 


230 FOR i = 0 TO 2:: CLS #i : END FOR i 
240 : 

250 REPeat demo 

260 get_3_points : Tor3pt 


270 END REPeat demo 
280 : 
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REMark graphic ratio horizontal to vertical 
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290 
300 
310 
320 
330 
340 
350 
360 
370 
380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 
870 
880 
890 
900 
910 
920 
930 
940 
950 
960 
970 
980 


DEFine PROCedure get_3_points 

RESTORE 

DIM t3(3,4) 

REMark t3 for triangle x, y, included angle, length of side 
REMark use +3(0,0) for sum of angles == 180 degrees 

REMark use t3(0,1) for maximum angle in degrees 

REMark use t3(0,2) for location of greatest angle 

INPUT#O;"" [D]Jata, or [RJandom, [Kleyboard or [Q]uit ? ";ans$ 
IF ans$=="Q" : CLS#0 : STOP 

FOR i = 1 TO 3 

FOR j = 1 TO 2 

IF ans$ == "D" THEN 

READ t3(i,j) 

END IF 

IF ans$ == "R" THEN 

t3 (i,j) = (RND * 50) — 25 

IF j = 1: t3(i,j)= t3(i,j) * We_hev 

END IF 

IF ans$== "K" THEN 

PRINT #0;"Point #";i!!CHR$(CODE( 'w')+j); 


INPUT#O;" value ? ";t3(i,j), 
END IF 

END FOR j 

IF ans$=='K': PRINT #0\ 

END FOR i 


REMark get limits for rescaling 

min_x = 1E6 : min_y = 1E6 : max_x = -1E6 : max_y = -1E6 
FOR i = 1 TO 3 

max_x = MAX( max_x, 3(i,1)) : min_x = MIN(min_x, t3(i,1)) 
max_y = MAX( max_y, t3(i,2)) : min_y = MIN(min_y, +3(i,2)) 
END FOR i 


REMark rescale window to suit input values 

zoom = 2.5 : REMark to show equilateral constructs 
h_range = max_x - min_x : mid_x = (max_x + min_x)/2 
v_range = max_y - min_y : mid_y = (max_y + min_y)/2 
image_aspect = h_range/v_range : REMark width/height 
REMark what is relation between window and image ? 
window2image = Wg_h2v/image_aspect 

IF window2image >= 1 THEN 

REMark it should fit across ok, height governs 
win_scale = v_range * zoom 

ELSE 

REMark it will fit up & down ok, width governs 
win_scale = (h_range¥zoom) /Wg_h2v 

END IF 

gr_wi = win_scale * Wg_h2v 

x_off = min_x -— (gr_wi — h_range) / 2 

y_off = min_y - (win_scale -— v_range) / 2 

REMark use offsets to "center" triangle 

SCALE win_scale, x_off, y_off : PAPER 2 :INK 7: CLS 
END DEFine get_3_points 


DEFine PROCedure Tor3pt 

REMark show 0, 0, x, y axes 

LINE x_off,0 TO (gr_wi + x_off), 0 

LINE 0,y_off TO 0,(y_off + win_scale) 

INK 0 : show_t3 :INK 7 

REMark work out included angle at each point 

FOR i = 1 TO 3 

frm_pt = CYC(i-1,3) : to_pt = CYC(i+1,3) 

REMark get bearings 

brg_1 = angl_frm(+3(i,1),t3(i,2),t3(frm_pt,1),t3(frm_pt,2)) 
brg_2 = angl_frm(+3(i,1),t3(i,2),t3(to_pt,1),t3(to_pt,2)) 
incl_ang = ABS(brg_2 — brg_1) 

IF incl_ang » 180 : incl_ang = 360 - incl_ang 
+3(i,3)=inel_ang 

REMark which is the greatest angle ? 

IF t3(i,3)>t3(0,1) THEN 

t3(0, 1)=t3(1,3) : +3(0,2)=i 

END IF 
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990 +3(0,0)=t3(0,0)+t3(i,3) 


1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 


REMark get length of side opposite vertex 


+3(1,4)=dist_btwn(t3(frm_pt,1),t3(frm_pt, 2) ,t3(to_pt,1),t3(to_pt,2)) 


END FOR i 

REMark get external points for Simpson line. 
REMark but not if »= 120° angle ! 

IF ¢3(0,1) « 120 THEN 

DIM sim(3,4) 


REMark sim for Simpson lines external point x, y, slope, intercept 


REMark use sim(i,O) for length of Simpson line 
FOR i = 1 TO 3 
frm_pt = CYC(i-1,3) : to_pt = CYC(i+1,3) 


DIM b1(2,2) : REMark baseline for equilateral triangle 


b1(1,1)=t3(frm_pt,1) : b1(1,2)=t3(frm_pt, 2) 
bl(2,1)=t3(to_pt,1) : b1(2,2)=t3(to_pt,2) 
external_point 

END FOR i 

min_len = (sim(1,0)+sim(2,0)+sim(3,0))/3 

tor3 : CIRCLE tors(0,1),tors(0,2), win_scale/32 
ELSE 

CIRCLE +3(t3(0,2),1),t3(t3(0,2),2), win_scale/32 
END IF 

INK 0 : show_t3 : INK 7 : REMark refresh triangle 
recap 

IF ans$<>"K" : CLS#0 

PRINT#O\\,, "touch [spacebar] to continue” 

PAUSE 

FOR i = 0 TO 2: CLS#i : END FOR i 

END DEFine Tor3pt 


DEFine PROCedure recap 
PRINT #2\ 
PRINT #2; "#U LT" x" y"\\ 


FOR i = 1 TO 3: PRINT#2; i!!t3(i,1),t3(i,2) : END FOR i 


PRINT #2\\"#"!!" Angle ";CHR$(186)," Length"\\ 


FOR i = 1 TO 3: PRINT#2; i!!t3(i,3),t3(1,4) : END FOR i 


PRINT #2\\"location of Torricelli Point"\\ 
11 = CYC(t3(0,2)-1,3) : 12 = CYC(t3(0,2)4+1,3) 
shortsides = t3(11,4)+t3(12,4) 

IF t3(0,1)<« 120 THEN 

PRINT#2 ;tors(0,1),tors(0,2) 

PRINT#2\'minimum length = ';min_len 

PRINT#2; min_len/shortsides;" of shortsides" 
ELSE 

PRINT #2;" >= 120"&CHR$(186)&", at point ";+3(0,2) 
PRINT #2; +3(t3(0,2),1),t3(+3(0,2) ,2) 

PRINT #2;"minimum length = 2 short sides = "; 
PRINT#2; shortsides 

END IF 

END DEFine recap 


DEFine PROCedure tor3 
DIM tors(3,2) 
FOR i = 1 TO 3 


tors(i,1)=-(sim(i,4)-sim(CYC(i+1,3),4))/(sim(i,3)-sim(CYC(i+1,3),3)) 


tors(i,2)=tors(i,1)*sim(i,3)+sim(i,4 


tors(0,1)=tors(0,1)+tors(i,1) : tors(0,2)=tors(0,2)+tors(i,2) 


END FOR i 
tors(0,1)=tors(0,1)/3 : tors(0,2)=tors(0,2)/3 
END DEFine tor3 


1590 : 


1600 
1610 
1620 
1630 
1640 
1650 
1660 


DEFine PROCedure show_t3 
LOCal i 
FOR i = 1 TO 3 


LINE t3(i,1),t3(i,2) TO t3(CYC(i+1,3),1),t3(CYC(i+1,3),2) 


CURSOR ¢3(i,1),t3(i,2),-4,-5:PRINT i 
END FOR i 
END DEFine show_t3 


1670 : 
REMark find points for equilateral triangles for given baseline 


1680 
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AUK 4-way trailing socket designed to switch off 
computer peripherals automatically when the 
computer is switched off, or (in the case of an ATX 
computer} when it auto-powers down. Compswitch 
has one control socket, and three switched sockets. 
Can be used with lights/hifi/monitors—ie a QL 
monitor can be used as a switch control. 


Cost £24 


superHermes 
A major hardware upgrade for the QL 

All Hermes features (working serl/2 at 19200, 
independent baud rates/de-bounced keyboard/ 
keyclick) IBM AT kbd I/F // HIGH SPEED RS232 at 
5§7606// serial mouse port and 2 other RS232 inputs// 
3 YO lines // EEPROM 
Cost (including manual/software) 
IBM AT UK layout Keyboard 
Serial mouse 
Capslock/serollock LED 
Keyboard or mouse lead £3 (£3.50/£3.50) 
High speed serial (ser3) lead £4 (£4.50/£4.50) 


Hermes available for £25 (£26/£27) Working ser1/2 and 
independent input, debounced keyboard. 

SuperHermes LITE: All Hermes features (see 
above) + an IBM AT keyboard interface only. 

Cost (incl keyboard lead) £53 (£54/£55) 


£90 (£92/£93) 
£11 (£13/£15) 
£8 (£8.50/£9) 
£1 (£1.50/£1.50) 


Fixed price for nnmnodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software. 


£27 incl 6 month guarantee 


The ORIGINAL system operating system upgrade 
OTHER FEATURES COMMON TO ALL VERSIONS 
DEBUGGED operating system/ autaboat on reset of power 
failure/ Multiple Basic/ faster scheduler- praphics (within 
10% of lightning) - string handling/ WHEN ERROR/ 2nd 
screen’ TRACE/ non-English keyboard drivers/ “warm” 
fast reset. V1.97 with split QUTPUT baud rates (+ Hermes) 

& built in Multibasic. 
First upgrade free. Otherwise send £3 (+£S5 for manual if requd). 
Send disk plus SAE or two IRCs 


MKI...£40 (£41/£43) MKIL..£65 (£66/£67) 


MINERVA RTC (MKID + battery for 256 bytes ram. 
CRASHPROOF clock & °C bus for interfacing. Can 
autoboot from battery backedram. Quick start-up. 


—_——— - PL RomDisq 
Up to 8 mbyte of flash memory for the QL 

A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent storage - 
it can be thought of as a portable hard disk on a card, 
and reads at some 2 mbytes per second. 

Think of it - you could fully boot an expanded QL, 
including all drivers/SMSQ etc off RomDisq at hard 
disk speed with only a memory expansion needed. 


2 mbytes RomDisq. £39 (£40/f41) 

4mbytes RomDisq. £65(£66/£67) 

8 mbytes RomDisq £98 (£99/£100) 
Aurora adaptor. £3 (£3.50/£4) 


MP LANE 


A low profile powered backplane with ROM port 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Card/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
outside) & QL motherboard in tower case. Specify ROM 
facing IN towards boards, or OUT towards back of case. 


£34 (£35/£36) 


Connects to Minerva MKII and any y Philips PC bu bus 


Power Driver Interface 16 1/O tines with 12 of these uedta 
control 8 current carrying outputs (source and sink capable) 
2 amp (for 8 relays, small mentors) £40 (£43/£44) 
4 amp total (for motors etc) £45 (£48/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 

£25 (£28/£29) 
Paral Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required £25 (£27/£28) 
Analogue Interface Gives eight 8 bit analogue to digital 
inputs (ADC) and two 8 bit digital to analogue outputs 
(AC). Used for temp measurements, sound sampling (to 
5 KHz), xy plotting. £30 (£31/£32) 
Temp probe (-40°C to +125°C) £10 (£10.50/£11) 
Connector for four temp probes £10 (£10.50/£11) 
Data sheets £2 (£2.50/£3) 
Control software & manual (for all /F) £2 (£2.50/£3) 


OL SPARES | 


17 PAL membrane 


8301/8302 or JM ROM or serial lead ‘£10 (£10. 50/£11 
Power supply (sea mail overseas), £12 (£19/£23 
Other components (sockets etc) also available 


Prices include postage aru packing (Airmail where applicable) Prices are: UK (Europe ‘Rest of world). Payment by cheque drawn on bank with UK 


address,/postal order or CASH! { can no longer accept card payments as UK ory does PDQ transaction. SAE or ERC for full list and details 


22 Feb OS 


29 Longfield Road, TRING, Herts, HP23 4DG 


Tel: +44 (0) 1442-828254 


Fax/BBS: +44 (0) 1442-828255 


tony@firshman.co.uk — http:/Avww.firshman.co.uk 
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1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
1960 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 
2210 
2220 


2230 : 


DEFine PROCedure external point 

REMark what's the slope of the baseline ? 

dx = (b1(2,1) — b1(1,1)) : dy = (b1(2,2) - b1(1,2)) 
IF dx : slope = ATAN(dy/dx) : ELSE slope = PI/2 
IF dy : slope2 = ACOT(dx/dy) : ELSE slope2 = 0 
IF dx <« 0: slope = slope + PI 

REMark distance of base line should == t3(i,4) 
db = SQRT(dx*dx + dy¥dy) 

alph = RAD(60—DEG(slope)) : beta = RAD(60+DEG(slope) ) 
ca=db*COS(alph) :cb=db*COS(beta) 
sa=db*SIN(alph) :sb=db*SIN(beta) 

REMark 2 checks for one side of line 

REMark from ptl 

elx=bl(1,1)+ca : ely=b1(1,2)-sa 

REMark from pt2 

e2x=bl(2,1)-eb : e2y=b1(2,2)-sb 

exil=(clx+e2x)/2 : eyl=(cly+c2y) /2 

REMark 2 checks for other side of line 

REMark from pt1l 

exl=bl(1,1)+ceb : cyl=b1(1,2)+sb 

REMark from pt2 

ex2=bl(2,1)-ca : cy2=b1(2,2)+sa 
ex2=(exl+ex2)/2 : ey2=(cyl+cy2) /2 

REMark which point is outside the triangle ? 
REMark ie, which is further from t3(i)? 
d_i=dist_btwn(ex1,ey1,t3(i,1),t3(i,2)) 
d_2=dist_btwn(ex2,ey2,t3(i,1),%3(1,2)) 


IF d.1 > d.2 THEN 

sim(i,1)=ex1 : sim(i,2)=ey1 

ELSE 

sim(i,1)=ex2 : sim(i,2)=ey2 

END IF 

REMark show external equilateral triangle 


POINT sim(i,1),sim(i,2) : LINE TO b1(1,1),b1(1,2) 
LINE TO b1(2,1),b1(2,2) : LINE TO sim(i,1), sim(i,2) 
REMark show Simpson line 

INK 4 : LINE sim(i,1),sim(i,2) TO t3(i,1),t3(i,2) 
REMark show triangle 

INK 7 : show_t3 

sim(i,3) = pts2mb(sim(i,1),sim(i,2), t3(i,1),t3(i,2)) 
sim(i,4) = b 
sim(i,0)=dist_btwn(sim(i,1),sim(i,2),t3(i,1),t3(i,2)) 
END DEFine external_point 


REMark convert 2 points of a line to y = mx +b 

DEFine FuNction pts2mb (x1,y1,x2,y2) 

m = (y2-yi)/(x2-x1) : bl = yi-(m * x1) : b2 = y2-(m * x2) 
b = (b1 + b2)/2 

RETurn m 

RETurn b 

END DEFine 


REMark DATA for 3 cities in GG#33 
DATA 0, 50, -81, 10, -17, -67 


2240 : 


2250 : 


2260 
2270 


2280 : 


2290 


REMark merge in CYC, angl_frm, dist_btwn, MIN, MAX, etc. 
REMark see GG#24, Vol.6, Iss.3, Sep/Okt 2001, p.38 


REMark end of listing Torricel1li3_bas 


The parts that would be merged: 


2300 : 


2310 
2320 
2330 
2340 


REMark angl frm 

DEFine FuNetion dist_btwn(xpt,ypt,x,y) 

REMark distance between two points xpt,ypt as point of origin 
xdis = (x-xpt) : ydis = (y-ypt) 


10 


QL foday 


2350 sqdist = ((xdis*xdis)+(ydis*ydis) ) 

2360 IF sqdist » 0 THEN 

2370 dbtw = SQRT(sqdist) 

2380 ELSE 

2390 dbtw = 0 

2400 END IF 

2410 RETurn dbtw 

2420 RETurn xdis 

2430 RETurn ydis 

2440 END DEFine :REMark FN dist_btwn(xpt,ypt,x,y) 


2460 DEFine FuNetion angl_ frm(xf,yf,xt,yt) 

2470 REMark angle in degrees from origin(xf,yf) to (xt,yt) 
2480 REMark --» = 0° or 360°, ® = 90°, «— = 180’, = 270° 
2490 IF dist_btwn(xf,yf,xt,yt) = 0 THEN 

2500 PRINT #0;"same spot!" :PAUSE 20:spolangle = 0 

2510 END IF 

2520 qdx=1 :qdy = 2 

2530 IF ydis<0 : qdy=qdy+2 

2540 IF xdis<O : qdx=qdx+2 

2550 qprd = qdy*qdx : qsum =qdy+qdx+qprd 

2560 quadA = ((INT((qsum+1) /3))/2) 

2570 quadB = (quadA—INT(quadA) )*5 

2580 quad = quadBiquadA :REMark Trig quadrant I, II, III, or IV 
2590 IF dbtw«>0 THEN 

2600 sinrat = ydis/dbtw 

2610 IF sinrat » 1 THEN sinrat = 1 

2620 IF sinrat « -1 THEN sinrat = -1 

2630 sangle = DEG(ASIN(sinrat) ) 

2640 SELect ON quad 

2650 = 1 :spolangle = sangle 

2660 = 2 :spolangle = 180—sangle 

3 :spolangle = 180-sangle 

4 :spolangle = 360+sangle 

2690 = REMAINDER : PRINT #0;"quad error arcsine":STOP 
2700 END SELect 

2710 END IF 


ou 


nN 
oO 
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oO 
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2730 angle_from = spolangle 

2740 RETurn angle_from 

2750 RETurn quad 

2760 END DEFine :REMark FN ang] _frm(xf,yf,xt,yt) 


2770 : 

2780 DEFine PROCedure SWAP (n1,n2) 
2790 ni = nl + n2 

2800 ne = ni —- n2 

2810 ni = ni — n2 

2820 END DEFine SWAP 

2830 : 


2840 DEFine FuNction CYC (Number%,cycle_length?) 

2850 REMark cyclic modular with option base = 1 vs option base 0 
2860 REMark Number% is an integer number 

2870 REMark cycle_length% is the Length of the cycle 

2880 RETurn ((Number%-1) MOD cycle_length%)+1 

2890 END DEFine CYC 


2910 DEFine FuNetion SGN(n) 
2920 RETurn (n0) - (n<O) 
2930 END DEFine SGN 


2950 DEFine FuNction MAX(a,b) 
2960 RETurn a*(a>b)+b*(b»a)+a%(a=b) 
2970 END DEFine 


2990 DEFine FuNetion MIN(a,b) 
3000 RETurn a*(acb)+b*(b< a)+a%(a=b) 
3010 END DEFine 


= 
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QLTDIS Part 10 


Norman Dunbar 


Here we are again 

After an absence of a couple 
of issues, I'm back again. Im in 
the middle of a small problem 
here at home and at work 
whereby | no longer have ac- 
cess to a Zip drive so | am 
unable to get at my wandering 
version of QPC where all my 
source code lives. This was 
the primary cause of there not 
being an article in the last is- 
sue ~ but who knows, maybe 
that pleased some of you! 


Anyway, I'm back again, still 
without Zio drive, but | found 
an older version of QPC on my 
hard drive and although it is 
not quite as up to date as the 
Zip drive is, it is workable for 
now. 


In the last episode, | left you in a 
position of having — finished 
entering the last bit of code to 
do the instruction decoding. You 
should now have a working 
version of QLTdis to play with. 
Obviously, there are bits we stil 
need to sort out such as the 
ability to write to the printer file 
as well as the screen. That 
comes in a future article. For 
now, here are some more 
corrections! 


As ever, there are 


bugs! 

If you remember back to a 
previous article which | know 
as part 8, then you will have 
been told of a fix to the 
type_24 code because | had 
found that ADDX/SUBX were 
being wrongly decoded as a 
type 24 instead of a type 30. 


The fix | gave you was to 
check bits 8,5 & 4 for 1,0 & 0 
as this applied to ADDX/SUBX 
only and not to any other of 
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the ADD/SUB instructions. Well, 
| have to admit that | was pro- 
bably smoking something 
strange when | figured that lot 
out (| may just have been tired 
as | don't smoke!) because It is 
completely and utterly wrong! 
The fix | gave results in instruc- 
tions like ADDAL A6,A4 being 
decoded as ADDX8? 
~(A6)-(A4) where the '?' is a 
blotch character on the screen. 
This is simply because the fix 
decoded the instruction as a 
type 30 ADDX when in actual 
fact it is ADDA, but ADDX 
doesnt allow the size bits to 
both be 1 whereas ADDA 
does! 


The correct fix that | should 


follows: 
IF BIT_8 = 0 THEN 
ELSE 
IF BITS_76 «> 11 THEN 
IF BITS_54 «> 00 THEN 


ELSE 


on the table below. 


Ht 

| Bits 876 | Possible OP-CODE 
000 | ADDI ADDQ ADD 
001 | ADDI ADDQ ADD 
010 | ADDI ADDQ ADD 


| 
| 
| 
| 100 
| 


011 | ADDA.W 

| ADDX ADD 
101 | ADDX ADD 
110 | ADDX ADD 
111 | ADDA.L 


¥ 
* 
¥ 
* 
* 
% 
¥ 
% 
¥ 
¥ 
¥ 
* 
* 
% 
% 
® 
¥ 
¥ 
% 
¥ 
% 
* 
% 
% 
¥ 
¥ 
¥ 
* 
¥ 
* 
x 
¥ 
% 


¥ 


pt st 


have given you is to test bit 8, 
if it is clear then this cannot be 
ADDX or SUBX because bit 8 
is always set in those instruc- 
tions. Assuming that bit 8 is 
set, then if bits 7 and 6 are 
both set, then again this cannot 
be ADDX/SUBX as these are 
never both set in those instruc- 
tions. 


At this point we have bits 876 
set to 100, 101 or 110 which 
you can see from the table 
below could be ADDX/SUBX 
or ADD/SUB so now we test 
bits 54 for 00 and if found, we 
must have an ADDX/SUBX be- 
cause this combination of bits 
is not permitted in ADD/SUB. 
Easy or what? 


Ye a ee eee 
TYPE_24 the ADDs and SUBs. We need to trap ADDX and SUBX here as well and, 
if found, redirect to type 30 below. This can be done by checking as 


Jump over further ADDX testing as it cannot possibly be ADDX 


Jump over further ADDX testing as it cannot possibly be ADDX 


Do the ADDX setup so that type_30 works 
Jump to type_30 processing 


The following table shows all permutations of bits 876 and all possible 
op-codes that can have that specific value. The code above will work based 


at 


Bits 54 Tested ? 


00 = ADDX else ADD 
00 = ADDX else ADD 
00 = ADDX else ADD 


a 


* Of course, where I have put 'ADD' I also mean 'SUB' - just in case you were 


% wondering. 

% 

dtype_24 
btst #8, d0 
beq.s  +24_not_t30 


; If bit 8 is zero, cannot be ADDX/SUBX 
3 Easy bit done. 
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PWord English Dictionary v1.0 £15 


The ultimate UK english dictionary with over HALF A 
MILLION WORDS, compiled by Paul Merdinian who 
compiled the Mega dictionary for DP’s Speelchecker. 
Due to the sheer size, a Super Gold Card is the 
minimum requirement. 

Two versions are available: QTYP dictionary only on 
HD disk - £10 CD containing ASCII list, QTYP version, 
Solvit Plus (from Just Words) and the dictionary in the 
solvit format, cost £15. 


QL Cash Trader v3.7 £5 


A well established accounts package for the small to 
medium sized business, including automatic 
generation of profit & loss account, balance sheet, VAT 
returns, reports and analysis for audit trails and 
management decisions. Previously sold for over £100.* 


QL Payroll v3.5 £5 


Manage a payroll for a small to medium sized 
business. Handles up to 99 employees easily, 
producing P45s and P60s as well as the payslips on a 
monthly or weekly basis. Calculates tax and national 
insurance and is easy to update to take account of the 
current tax year rules. 


Sidewriter v1.08 
Image D v1.03 
Q-Help v1.06 
Q-Index v1.05 


Four excellent programs to assist the QL user. 
Sidewriter: Produce landscape printouts on Epson 
printers. 

Image D: Produce 3D pictures of objects. 

Q-Help: on-screen help for SuperBASIC commands. 
Q-Index: look up keywords related to topics. 

See earlier adverts for more detials. 


ProForma ESC/P2 Drivers v1.04 £8 
New improved colour and monochrome printer 
drivers, providing up to 720dpi for all programs 
written for use with ProWesS, such as LineDesign and 
Paragraph. Works on all Epson inkjet printers which 
support binary mode compression (740, 850 and 900 
models at least). 1440 dpi to follow. 


QL Genealogist v3.26 
Genealogy For Windows 
Store your family tree for posterity. Add individuals 


£20 


£50 


those links build up into a formal family tree layout. 
Text files and pictures may also be linked to 


the grid. 


time. 


SBASiIC/SuperBASIC Reference Manual 


Updates £6 each, £10 for 2 (Current Version - Rel 4) 
Have you ever tried to write a program, but been lost as to 
the means of performing a certain action? This Reference 
Manual provides you with a full description and examples of 
how to use all of the keywords found on each of the 
different QLs, plus SMSQ/e, Toolkit I] and many different 
public domain toolkits. Details of any possible problems are 
provided, together with descriptions of how to use the 
device drivers and how to ensure that your programs are 


Q-Word *COMING SOON* 


The ultimate word game for the OL - you are given a grid of 
letters and need to link letters together to form as many 
words as possible. Points are based on both the number of 
words and their length, as well as letters used. As you use a 
letter, it is removed from the grid, with the object to clear 


£tba 


Using high colour graphics on all systems which support 
more than 8 colours (including Aurora), background music 
and much more, this will keep you entertained for a long 


compatible across the range of QL platforms. 


This book is ideal for all QL users and is kept up to date with 


regular updates. ** Currently Out of Print ** 


QL Cosmos v2.04 


Ever wondered what the stars in the sky looked like 100 
years ago? Or, maybe you want to learn the constellations 
and names of what you see in the sky. This is the program 
for you - generates pictures of the stars and planets for any 
given place or time and provides details on these objects. 
Includes Halley's Comet, the Moon and the Solar System 


planets. 


Q-Route v2.00 


Upgrade from v1.xx 


The latest version of this popular route finding program. 
Find the quickest route or the shortest route between any 
two places, using roads. A wide range of maps is available 
for this program (see elsewhere in this advert). The program 
is easy and quick to use. You can even add your own places 
and roads to the maps to include local detail. 


Software). 


Flashback SE v2.03 (Upgrade only) 


The ultimate database program - extremely fast and flexible, 
easy to use, updated to cope with the latest versions of the 
QL operating system and still maintained. A report module is 
included to allow you to format output in any way, including 
mail-merge. Unfortunately only available as an upgrade from 
the original version (original still available from Sector 


Return To Eden v3.08 


Nemesis M 
The Prawn 


KII v2.03 
v2.01 


Horrorday v3.1 


West v2.00 


The Lost Kingdom of Zkul v2.01 


with details of their parents and children, watch all of A wealth of QL adventures - mainly text only. 
Save the Galaxy from the ambitions of the evil dictator 


Nemesis. 


£5 


£25 


£5 


£5 


individuals as well as notes and events, making this Battle against werewolves and dracula look-alikes on a 
Hammer Horror set in the comical Horrorday. 

QL version now supports FileInfo Il and QMenu as well Take the part of a prawn with a hangover, lost in a strange 
land in the hilarious Prawn. 
Solve a bank-robbery by fighting the bad guys and 


the perfect way to preserve the history of your family. 


as allowing you to link both male and female trees. 
Sample tree of the Royal family since 1066 included. 


PC version is event driven - enter the details as they collecting the loot in real-time old West. 


appear in documents and it generates the tree from Battle countless dwarves in the atmospheric Lost Kingdom 


these. QL data and GEDCOM can be transferred to the 


of Zkul. 


PC version. Upgrade to latest PC version (v5.21) for £8 Return to Eden is a massive adventure over 3 disks with 
Both programs easy to use and complete with a step by colourful graphics - control 3 characters in their quest to 
find the missing Prince. 
All six adventures are available together for only £25. 


step tutorial. 
** QL USERS upgrade to PC version for £25 ONLY ** 
£10 
£8 
War In The East MKIil v1.24 
(Upgrade Only) £5 


D-Day MKIl v3.04 
Grey Wolf v1.8 


WF9 5JH 
TEL: 01977 610509 


im 
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http://hometown.aol.co.uk/RWAPSoftware 
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For the gaming enthusiast - D-Day is a classic table top wargame for one or 
two players - you control either the Allies or the Axis forces during WWII. 
With the ability to define your own army set ups and a choice of 4 different 
scenarios, this should keep you entertained for a while. 
Grey Wolf is a graphical simulation of a submarine - can you sink the enemy 
shipping whilst avoiding their planes and destroyers?? 


RWAP Software, 35 Chantry Croft, 
eae Kinsley, Pontefract, West Yorkshire 


* Also known as Trading Accounts 


Cheques 


payable to 'R.Mellor' 


£40 


Flight simulator 


Plenty of variation and 


quired - what more can you ask for? 


games. 
All 6 programs only £28. 


questions). Others are fast, 


like Golf and a pub quiz 
colourful arcade 


A range of games to keep both the young 
and the young at heart amused. Some are 


also now available. 


program (500+ 
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Britain.map v1.11 
Catalonia Map 


in £sterling 
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move.w 4d0,d4 ; Using D4 later with the op-code word 

andi.w #$00c0,d0 ; Mask out bits 7 & 6 of the op-code 

empi.w #$00c0,d0 ; Both set ? 

beq.s  +24_not_t30 ; No, skip over type 30 stuff 
t24_type_30 


andi.w #$0030,d4 ; Preserve only bits 5 & 4 of the op-code 
bne.s  +24_not_t30 ; If not both unset, skip ADDX/SUBX setup 
move.w d7,d0 ; Retrieve the op-code again 
move.w 0,d4 ; Working register 

andi.w #$f000,d4 ; Keep top 4 bits only 

empi.w #$9000, a4 ; SUBX ? 

bne.s +24_addx 3 No, skip 


The remainder of the type_24 code is correct, only the above 
needs to be changed. 


Debugging with QMONY. 


Ok, the above code is correct and works, but it didn't originally. 
Everything was being decoded as ADD or SUB even when | 
tested a file containing ADDX and SUBX instructions. What was 
going wrong? Well the original code looked like the following: 


dtype_24 
btst #8, d0 
beq.s  +24_not_t30 
move.w d0,d4 


3 If bit 8 is zero, cannot be ADDX/SUBX 
; Easy bit done. 
; Using D4 later with the op-code word 


andi.w #$00c0,d0 ; Mask out bits 7 & 6 of the op-code 
empi.w #$00c0, 40 ; Both set ? 
bne.s  +24_not_t30 ; No, skip over type 30 stuff 


As the original programmer of this code, when | read through it, 
everything seemed fine - as it always does - but obviously, 
something was amiss. The rest of this exciting article, is a brief 
foray into the art of debugging using QMONZ. 


QMON2 is Tony Tebby’s original disassembler/monitor tool which 
allows a QDOSMSQ job code or SuperBasic extension or CALLed 
code to be debugged by single stepping through the guts of the 
code until you find the bit that isn't doing what it is supposed to be 
doing. 


| have been using QMON2 to help me debug code for years and 
although | don't use it as often as | should perhaps, | do happen to 
like it quite a lot. It seems, unfortunately, that it is no longer 
available in its English format as Digital Precision still hold the rights 
to the program - as far as | am aware - but in Germany, you can 
get a copy from Jochen. Actually, you can get a copy from Jochen 
in any country in the world, provided you are able to read and 
understand German manuals :o) 


QMON2 is fine, but as we don't yet have anything like a source 
code debugger on the QL, it is a bit difficult to figure out where to 
put breakpoints in your code so that you don't spend ages single 
stepping through code you know works to find the bit that doesn't 
work. 
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George Gwilt has provided a 
little helo here, so not only 
does he supply you with a 
neat little assembler but he 
also. gives you help in 
debugging as well. 


When you have assembled the 
code for QLIdis there is a 
listing file created with the 
_LST extension, but another 
file is created with a _SYM 
extension. This file holds the 
goodies we need to debug. 


The SYM file is binary and 
holds a list of all your equates 
in it, plus a list of all the 
program labels and their offset 
from the start of the program. 
So, if you think that you have a 
bug in a specific routine, all you 
have to do is decode the SYM 
file to extract the routine’s 
offset from the start of the 
program and set a breakpoint 
at that place in the code. The 
problem is, how exactly do you 
decode the binary file ? 


George does not document 
the SYM file format, so you 
could assemble a few routines 
and see if you can make any 
sense of the binary file, but 
there is a much easier way. 
Simply by running — the 
SYM_BIN program — supplied 
with GWASL you feed it a SYM 
file and it spits out a text file 
holding all the data you wil 
ever need. The output file is 
named the same as the SYM 
file but with a further _LST 
extension, so | __ have 
‘dev2_source_aqltdis_sym_Ist’ 
as my file. 


The following is a small extract 
from this file on my system. 
Yours may well look different, 
but don't worry if it does. The 
first part of the file matches up 
with my equates: 
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CON_ID EQU  $00000000 
CON_ID2 EQU $00000004 
PRT_ID EQU  $00000008 
PC_ADDR EQU $0000000C 
PC_END EQU $00000010 
BLACK EQU $00000000 
RED EQU $00000002 
GREEN EQU $00000004 
WHITE EQU $00000007 
LINEFEED EQU $0000000A 
OOPS EQU $FFFFFFFF 
ERR_NC EQU $FFFFFFFF 
INFINITE EQU  $FFFFFFFF 
ME EQU $FFFFFFFF 


Then we get to the nitty gritty, the labels | have 
used in my source code and their offsets from 
the start of the program. The first one is my label 
‘start’ and it is actually the very first instruiction in 
the file, so it has offset zero. Following on are all 
the other labels | used. 


START EQU %*+$00000000 
QLTDIS EQU %*+$00000010 
JOB_INIT EQU ¥*+$0000003E 
EXIT EQU *+$0000003A 


.. a few dozen lines removed for brevity! 


*+$00000B9A 
¥+$00000BAC 


DTYPE_23 EQU 
DTYPE_24 EQU 


.. another few dozen lines removed for brevity! 


We can see that regardless of the start address 
of the program when loaded into memory (by 
QMON2 or JMON2) we can still work out where 
the code for the DTYPE_24 routine, for example, 
starts simply by adding SOBAC to the actual start 
address of the program. 


The following is a small session showing how | 
debugged through my DTYPE_24 routine to fix 
the above mentioned problem. 


So, to set the scene, | have edited the source 
code for the type 24 instructions, assembled 
QLTdis and produced a new listing of the SYM file. 
've looked through the listing and found that my 
entry point for DTYPE_24 is at offset SOBAC. | 
then start up JMON2 (in this case, but QMONZ2 is 
exactly the same): 


jmon 'winl_source_qltdis_qltdis_bin' 


If you try this and get an error make sure you 
have LRESPR'd the JMON_BIN code for JMON2 
or the QMON_BIN code for QMON2 depending 
on which one you want to use. 
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When the monitor appears, the very first instruc- 
tion in the job has already been executed, so | 
could be anywhere in the job file. Because | have 
written the code myself, | know what the very 
first instruction is, it is ‘BRAS QLTDIS’. Because | 
know this, | know that the instruction | am looking 
at must be the code at label ‘QLTDIS’. 


lf | was debugging some other code that | did 
not have the original nicely commented source 
files for then | would not know where | was in the 
actual job, or extension, as the first instruction 
could have sent me off into any location in its 
own code or even into the ROM. 


In this case | have jumped from label ‘START’ to 
label ‘QLTDIS’ and there are quite a few bytes 
between the two labels. QMON is showing me a 
register dump and the address of, the op-code 
word and the next instruction to be executed. 
For the sake of brevity, I've omitted the register 
dump itself 


1AOEB8 6100 BSR.L $1A0EE6 


So, I'm somewhere in the code for QLIdis, but 
where. | know |'m at the instruction at address 
$1A0EB8 but what is the start address of the job 
itself? 


The QMON command 'C’ will calculate an ad- 
dress and the option 'S’ will display the start ad- 
dress of the job. 


QMON» CS 
OO1A0EA8 1707688 

This is the Hexadecimal and decimal values for 
the start of the QLTdis job I'm trying to debug. 
How can | be sure? Try dissassembling the start 
address for a couple of instructions: 


QMON> DI S 5 

1AOEA8 600E BRA.S $1A0EB8 
1AOEAA 0000 ORI.B #0,D0 
1AOEAE 4AFB ILLEGAL 

1A0EBO 0006 ORI.B #$4C,D6 
1AOEB4 5464 ADDQ.W #2,—(A4) 


The first line is the one to look at, it shows a 
branch to address $1AOEB8 that QMON was 
showing me originally as the second instruction 
to be executed. So, the 'S' value does appear to 
be my label for ‘START’ and this is what | want. 


So, | know that the routine | want to check out is 
‘DTYPE_24' and that it is at an offset of SOBAC 
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from start, what address Is this? Again using the 
C command to calculate an address, | do this: 


QMON> C S+$0BAC 
OO1A1A54 1710676 


| now know where my routine starts, again, to 
check that It is so, | can disassemble the first few 
instructions: 


QMON> DI S+$OBAC 5 
1A1A54 0800 BTST #$8,D0 
1A1A54 6732 BEQ.S $1A1A8C 
1A1A54 3800 MOVE.W DO,D4 
1A1A54 0240 ANDI.W $C0,D0 
1A1A54 0800 CMPI.W $C0,DO 


this looks remarkably like the correct code to 
me, so | can now set a breakpoint at this address 
and let QMON teil me when | get there. Of course, 
if | was debugging someone else’s code, | 
wouldn't have a handy list of offsets into the 
program, so | would have to run through it step 
by step by step until | found out where the code | 
wanted to check was. Once I'd reached that 
stage, | would make a note of the address and 
calculate the offset from the start so that | could 
easily set a breakpoint there on my next foray 
into the debugging session. It's much easier 
when you have the source! 


Anyway, | set a breakpoint as follows using the 
‘B’ command. 


QMON> B S+$0BAC 
BRP 1A1A54 


| could also have simply used the calculated ad- 
dress from earlier by typing 'B $1A1A54’ which 
would have had the same effect. Note that if | set 
a break point at the same address it will delete 
the breakpoint at that address. The 'B’ command 
is a toggle. 


Again, this is what my code originally looked like 
when | was debugging the fix for this instruction 


type: 


dtype_24 
btst #8, d0 3 If bit 8 is zero, 

3 cannot be ADDX/SUBX 
beq.s +24 not_t30 ; Easy bit done. 
Move.w 4d0,d4 ; Using D4 later with 

3 the op-code word 
andi.w #$00c0,d0 ; Mask out bits 7 & 6 

3; of the op-code 
empi.w #$00c0,d0 3; Both set ? 
bne.s +t24_not_t30 ; No, skip over type 

3; 30 stuff 
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Now I'm ready to go, so | simply type the QMON 
go command which is 'G’. 


QMON> G 


The 'G’ command means, Go until you hit a 
breakpoint or finish the program. It causes the 
program to run at nearly full soeed. This means | 
get all the clear screens and prompts etc that | 
would normally get when running the program 
without the debugger. | therefore need to enter a 
Start address and so on to get the disassembler 
to start working. 


| have already loaded a file of assembled ADDX 
and SUBX instructions into an area of memory 
that | allocated with ALCHP and | have its ad- 
dress written down on paper - my own memory 
is a bit random these days. 


After | have typed in the start and end addresses 
(and the printer device) | return to the QMON 
prompt with a register dump and the address, 
hex code and decoded instruction for the next 
instruction to be executed: 


At brp SR 0000 --O----—— SSP 00028480 
DO-D3 0000D300 01BC0924 0000003C FFFFFFFF 
D4-D7 0013FFFF 00000000 00000003 0013D300 
AO-A3 004C0016 001A1601 001A11DD 001A1130 
A4—-A7 001A2362 001A11DD 0013A3C8 001A32Fa 
1A1A54 0800 BIST #$8,D0 

QMON> 


Taking the above a section at a time, we have 
this first: 


At brp SR 0000 —0---—-— SSP 00028480 


This is telling me that Im stopped at a breakpoint 
~ ‘at brp’ - and the contents of the status register 
in hex — 0000. Next to that is the interrupt mask 
value - 0 then 5 dashes shoing the current state 
of the CCR flags. As all are showing dashes, 
none of the flags are set. Finally, there is the 
current value of the ‘alternative’ stack pointer. In 
this case I'm running in user mode, so | can see 
the SSP (supervisor stack pointer) value. 

Below the status line is a register dump showing 
the current values of all data and address 
registers. 


DO-D3 0000D300 01BC0924 0000003C FFFFFFFF 
D4—D7 0013FFFF 00000000 00000003 0013D300 
AO-A3 004C0016 001A1601 001A11DD 001A1130 
A4—-A7 00142362 001A11DD 0013A3C8 001A32Fa 
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In my case | have the registers split over two 
lines each for data and address values. This 
depends on the width of the channel to which 
QMON2 is writing the register dump. 


Below the register dump is the address, the 
op-code word and the disassembled instruction 
for the next instruction to be executed. Under 
that is the QMON2 prompt. 


1A1A54 0800 BIST #$8,D0 
QMON> 


Back to the debugging session. | want to know 
what is causing my ADDX instructions to be 
decoded as ADD. So, | have my source listing for 
Type_24 instructions, and because I've hit the 
breakpoint | set, | know that an ADDX is coming 
through the type_24 decoding routine before 
jumping into the type_30 decode - or is it? | 
need to find out. 


The register dump shows me the op-code in 
DOW and also in D7W it is $D300 which is ADDX 
DO,D1. The op-code in binary is as follows, the 
bit numbers are in HEX above the individual bits 
themselves: 


C 8 4 0 
1101 0011 0000 0000 


Lets trace through the code and see what 
happens. Remember that the next instruction to 
be executed is showing just above the QMON 
prompt, so when | enter the ‘T’ for Trace 
command, | will be executing the instruction 
‘BIST #80’ Let's do it. 


QMON> T 

SR 0000 —-O---— SSP 00028480 
1A1A58 6732 BEQ.S $1A1A8C 
QMON> 


'm not showing the register dumps, unless there 
is anything of interest in the registers. This helps 
cut down on the amount of paper Jochen needs 
to buy to get the magazine printed! 


We have tested bit 8 of DO and found that it is 
not zero because the Z flag is not showing in the 
list of flags. This has to be an ADDX, ADD or an 
ADDAL instruction (see the table in my explana- 
tion of type_24 decoding above). Let's step 
again. 


QMON> T 
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SR 0000 --O--—— SSP 00028480 
1A1A5A 3800 MOVE.W DO,D4 
QMON> 


Nothing of interest here, step again : 


QMON» T 

SR 0008 —-0-N-—- SSP 00028480 
1A1A5C 0240 ANDI.W #$C0,DO 
QMON> 


Now it's starting to get interesting, the 'N’ flag is 
showing after we moved DOW to D4W - this 
shows that the most significant bit of the new 
value in D4W is set and thus the value in D4W is 
negative (if using signed arithmentic!). This is how 
QMON displays flags which have been set, the 
flag letter is displayed on the ‘SR’ line. 


Step again: 


QMON> T 

SR 0004 —-O—Z— SSP 00028480 

DO—D3 00000000 01BC0924 0000003C FFFFFFFF 
D4-D7 Ommitted 

AO-A3 Ommitted 

A4-A7 Ommitted 

1A1A60 O0C40 CMPI.W #$C0O,DO 

QMON> 


So, we have set the Z flag because DOW is now 
holding zero {Although DOLL is holding zero, the 
upper word was already zero only the lower 
word has changed because the instruction just 
executed ANDed a word value with DOW) The 
next instruction is waiting to be executed so lets 
do it. Step again: 


QMON> T 

SR 0009 —-0-N—C SSP 00028480 
1A1A64 6626 BNE.S $1A1A8C 
QMON> 


It looks like we are going to take the branch as 
the Zero flag is not set. Lets remind ourselves of 
what the original source code looked like again: 


dtype_24 
btst #8,da0 3 If bit 8 is zero, 

3; cannot be ADDX/SUBX 
beq.s t24_not_t30 ; Easy bit done. 
move.w d0,d4 3; Using D4 later with 

3 the op-code word 
andi.w #$00c0,d0 ; Mask out bits 7 & 6 

3; of the op—code 
empi.w #$00c0,d0 3 Both set ? 
bne.s t24_not_t30 ; No, skip over type 

3 30 stuff 
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SO you Can see where we have single stepped 
through the above code, and we are just about 
to jump to label 'T24_NOT_T30° because this 
instruction is not a type_30. Except, we know 
that it is an ADDX instruction because that is 
what | was testing, and ADDX Is a type_30, so 
what have | done wrong? 


| have tested bits 7 and 6 and found them both 
to be zero (because the Z flag was set after | 
stepped through the ANDIW $CO0,DO instruction. 
This means that the jump should not be taken to 
T24_NOT_T30 because | have not yet ascer- 
tained that the instruction is not an ADDX. With 
bits 7 and 6 set to 00, | could be looking at 
ADDX or ADD. | should not be taking the jump 
until | have further tested the value in bits 5 and 4 
as per my algorithm above. 


This could be why the ADDX is being decoded 
as ADD, because | have the wrong condition in 
my test. In order to fix this, | have to change the 
source code, re-assemble and try my test again. 
| do this without the QMON2 first of all and if it 
still fails, | can use QMON2 to try and find out 
why again. | need to give the current job a 'G’ 
instruction and then | can ESC from the decoding 
and exit the program. 


Programming QPTR in 
SBASIC 


W. Lenerz 


Second Part - Displaying Windows 


OK, by now | don't really know what part of this 
series were in anymore... (Kudos to Herb Schaaf 
for keeping his numbers up!). However, we've ar- 
rived at the second section of this little walk- 
through. 

Once we've defined our window, it’s time to put it 
up on the screen. Do not forget that the first 
window to be opended is very important - it Is 
the primary window, and all other windows (the 
secondary windows) must be within that primary 
window. The keywords for bringing windows 
onto the screen may be grouped into several 
sections: first, how to display the window in itself 
(I), then changing something within the window (Il) 
and, last but not least, opening channels) within 
the window. 

In the following explanations, | shall try to keep 
variable names coherent with what has gone 
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| shall go do that and report back. Hang on here 
for a bit ...... 


Ok, I'm back. | made the change from 'BNE.S' to 
‘BEQS' and it worked fine. So it looks like | have 
correctly identified the bug. | need more testing 
though to make sure | cover all possible op- 
codes. | have followed up my ADDX testing by 
passing test files which have ADD, ADDA, ADDQ 
and ADDI instructions, along with assorted SUB 
variants and all appears to be working well 


So there you have it, an example of how | ma- 
nage to get my code wrong and how | can use 
the tools available to try to sort it out. As | men- 
tioned earlier, QMON2 is available from Jochen 
for a small fee, but only if you understand Ger- 
man manuals. 


Laurence (Lau) Reeves has a different version of 
QMON2, written by himself, which fixes some 
bugs but | don't know if this is widely available or 
if it comes with a manual. Perhaps he could be 
persuaded to part with it or make it available - 
who knows. I'm not sure if he ever wrote a 
manual for it though. 


See you next time. 


before, whenever the same variables are to be 
used. 


| - Displaying the window 

There are two purposes for this. The main pur- 
pose, of course, is to display the content of the 
window. Second, one wants to make the window 
"managed” by the Pointer Environment. Indeed, 
only a window properly managed by the Pointer 
Environment may profit from all of the advantages 
granted by that Environment. 

There are two keywords for displaying windows 
in the Pointer Environment. There is also a key- 
word to make an already existing window a "ma- 
naged” window. Attention, we're talking about dis- 
playing the main (primary and secondary) win- 
dow itself, not the sub-windows. There is no key- 
word to display the subwindows specifically - 
they are displayed automatically with the primary 
or secondary window. 


A - making an existing window "managed" 
The command “OUTLN” (OUTLINe) makes an 


existing window managed and makes the Pointer 
Environment aware of the window. The window 
concerned is one opened with a normal OPEN’ 
command. 
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QO-Celt Computing 


The Falconry, Glenmacnass, Glendalough, Co. Wicklow, Ireland. 
Tel: (+353)-404-45319 Fax: (+353)-404-45558 Email: darren.branagh@boimail.com 


COMPACT FLASH ADAPTERS FOR THE QL!!! 
LAST REMAINING FEW - WHILE STOCKS LAST!! 


We have a limited quantity of the QL Compatible Compact Flash readers (previously sold by 
Phoebus Dokos) remaining for the QL. These are the last available anywhere, and are fully tried and 
tested with QPC, Q40/60, QXL, and even a QL with QubIDE. 


They are small in size (same size as a floppy drive roughly) and will fit in a floppy bay on a tower 
or desktop PC case, & will take all sizes of Compact flash cards. 


Only Standard ones remaining at £19 Sterling each, inc. P&P Worldwide. 


Please check on availability first as very few remain!! 


QL 2002 —- The DVD Movie!! 


A professionally edited and made DVD documentary (over an hour long!!) on the current QL scene, 
containing the recent QUANTA meeting and AGM in Manchester, and interviews with Bill 
Richardson and Tony Firshman. Complete with Outtakes, and a comprehensive trader directory and 
QL info slide show. The entire QL EMULATORS CD-Rom is also included FREE on the DVD 
disk! 

Will work on PC or Mac DVD drives and most standalone DVD Players. 


Only £29.95 Sterling inc. P&P Worldwide. 


COMING SOON —- NEW PROGRAM —- LAUNCHPAD!!! 


A Brand new program from Dilwyn Jones, one of the best QL programmers around. It’s a Program 

Launching front end, and allows you to assign Icons for your programs, to have your own desktop 

login, and other great ideas. I will be demo-ing this at the Irish Show on 30" August — come and be 
the first to see it!! 


3™ Trish QL Show ~ Ireland, 30° August 2003. 
Come to the Irish Show at the end of August — see the Show info in the magazine. 
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The syntax of OUTLN Is as follows: 
OUTIN [#channel, ]xs,ys,xo,yo 


The parameters are the same os for a normal 
open command: the window x and y sizes and 
the window x and y origins. ‘channel’ is channel 
11 by default. 

Please note that, when working in S*Basic, the 
normal Basic windows (channels #081 and #2) 
are not managed by the Pointer Environment in 
an automatic way. 

However, for a successful programming session 
with QPTR under S*basic, channel #0 (Basic’s 
“primary” window) must be managed by the 
Pointer Environment. Thus, channel #0 MUST be 
managed by the Pointer Environment at the start 
of the programming session - just use OUTLN for 
that. 

lf you don't do that, you will get many a bad 
surprise, as, notably, the pointer will not be read 
correctly, and your loose items will seem not to 
function correctly. 


B - Displaying the window 
Putting the window up on the screen is achieved 


with two commands: DR_PPOS and DR_PULD, 
Standing respectively for ‘DRaw Primary and 
POSition’ and "DRaw PULIDown window’. These 
are commands, not functions. They are very simi 
lar being responsible for displaying the window 
on the screen and making it managed by the 
Pointer Environment. The difference is that 
DR_PPOS is used only for primary windows, and 
DR_PULD is used for secondary windows (also 
called pulldown windows, hence the name of the 
command). Moreover DR_PPOS can use a chan- 
nel parameter, while DR_PULD doesn't (the chan- 
nel is opened automatically by that command). 


The entire parameter list for the commands is: 


DR_PPOS [#channel,] workdef, xpos%, ypos%, 
liflags%, appflags% [, xctrldef%, yctridef%] 


As mentioned above, the optional channel para- 
meter does not apply to DR_-PULD. 


>» * Workdef is the working definition as re- 
turned by MK_WDEF 


»* xpos% and ypos% are integers which de- 
termine, in a very roundabout fashion, the 
position of the window. Indeed, obtaining 
the window's initial position is a bit counter- 
intuitive: xpos% and ypos% do not deter- 
mine the x and y position of the upper left 
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hand of the window as could have been ex- 
pected. In fact, x and y determine the place 
where the POINTER will be on the screen 
once the window is drawn. The window is 
then drawn around this pointer position in 
such a way that the pointer is located at a 
predefined location within the window! 


Indeed, we saw earlier that one of the para- 
meters of the MK_WDEF command is the 
initial pointer position of the pointer within 
the window. Thus, when the primary win- 
dow is drawnthe sequence of events, for 
the positioning of the window is as follows: 


The pointer is set to the xpos%ypos% posi 
tion given as parameter to the DR_PPOS 
command. Then the initial pointer location of 
the pointer within the window is looked up. 
After that, the primary window is drawn 
around the pointer in such a way that the 
pointer is located exactly where it should be 
within the window. As mentioned above, a 
pretty roundabout way of handling things... 


Of course, determining where the window 
will effectively be drawn is easy, and can be 
calculated as xpos%-x and ypos%-y, where 
xpos% and ypos% are the parameters to 
the DR-PPOS command, and x and y are 
the parameters to the MK_DEFK function. 


As can be expected, this pretty complica- 
ted way of positioning the window does 
have a reason - it is possible to set the 
xpos% and ypos% parameters to -L. In this 
case, the window will be drawn in such a 
way that the pointer is not moved at all. This 
is to make sure that windows can appear 
where the pointer is, so that the user's 
focus (which is generally on the pointer) 
doesn't need to change. 


As a general way of doing things, this 
makes sense. The only difficulty arises 
when one wants a window to appear at a 
predefined position. | personally find the cal- 
culations to be made to ensure that the win- 
dow appears at a certain position too com- 
plicated. So what | generally do when a 
window must appear at a certain position, is 
to set the initial pointer position within the 
window to 0. That way, the xpos% and 
ypos% parameters to DR_PPOS do deter- 
mine the point where the window will be 
placed. After that, | just set the pointer 
position within the window with another 
QPTR command... 
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-) * 


-» * 


liflag% is an integer array of DiIMension (n-1) 
where nis the number of loose items the 
window contains. The array is used as a 
flag array, where each element of the array 
is a flag containing the statuses of the items 
- you might remember that each item can 
have several statuses (selected, available, 
unavailable and current item). When the 
window is drawn {and also later when the 
pointer is read) you will have to determine 
what status each item is to have - some 
items may be unavailable initially, or selected 
etc... This, of course depends entirely on the 
program. For a file copier for example, the 
Copy’ item might remain unavailable for as 
long the the user hasn't chosen source and 
target directories. 


Each loose menu item corresponds to one 
element in the array: liflag%(0) is for the first 
item, liflag%(l) for the second and so on. 
The values these flags can have are pretty 
simple, as follows: 


»Q — : the item is available 
> 16: the item is unavailable 
-» 128 : the item is selected. 


There is no special value to indicate the 
current item, because the Pointer Environ- 
ment itself automatically determines what 
item is the current item and then draws the 
border around it, and this depending on the 
pointer position. Thus, if you wish for any 
particular item to be the current item as 
soon as the window is displayed, you must 
set the pointer to such a position that it is 
"within’ this item. 

As the DiMension of the liflag% array de- 
pends entirely on the number of loose 
items, it is recommended to DIM this array at 
the same time one establishes the loose 
menu item list, because at that time one 
knows exactly how many loose Items there 
are in the window. 


appflag% is the same thing as liflag%, but 
for the menu application window(s}: there 
again, each object of a menu application 
window may have several statuses (the 
same ones as for loose menu items). There 
iS one array per application subwindow, and 
they are DiMmed_ as_ follows: DIM 
appflag%(row-l.sec-1) where row is the 
number of rows for all of the objects and 
sec is the number of sections. If there only 
is one section, then one uses DOM 
appflag%(row-1,0}. 
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>* ctridefx% is, again, an integer array of Di- 
mension crtidefx% (maxsec%2) where 
maxsec% is the number of sections as de- 
fined in the x control definition (horizontal). 
The values of this array are a bit special, as 
follows: 


(0,0) contains the number of control sec- 
tions {i.e maxsec%). 

(0.1) contains 1 if the control definition just 
changed, else 0. 


Then, for each control section i: 


(0) contains the start pixel position. 

(i1) contains the number of the first row 
shown. 

(2) contains the number of rows in this 
section. 


»* ctridefy% is, you will have guessed, the 
same thing for vertical sections and co- 
lumns, instead of horizontal sections and 
rows. 


Please note that the two last parameters are 
optional: if there is no contro! definition, they may 
be omitted or simply set to 0. However. there will 
be as many flag and definition arrays as there will 
be menu application subwindows (of course, they 
are not necessary for simple application subwin- 
dows). If you have several application subwin- 
dows, you may omit the flag arrays for those 
where you don't need them. 


These are all of the parameters for the two 
commands, DR_PPOS and DR_PULD. Both com- 
mands are similar they display a managed 
window on the screen. As was mentioned above, 
the main difference between these two com- 
mands is that DR_PPOS is used for the primary 
window, whereas DR_PULD is used for seconda- 
ry windows. DR_PPOS can use a CON channel 
(which must have been opened beforehand, the 
default channel being #1). 


The problem with that is that you have no chan- 
nel number for secondary windows. Indeed the 
DR_PULD command opens a window and a 
channel by itself (a channel of type CON) - but 
this channel is NOT accessible from S*Basic. 
There is no Basic channel number corrsponding 
to the window opended by DR_PULD. This is 
different for DR_PPOS which can use a channel 
in which all the normal operations (PRINT etc) can 
be made. Thus, DR-PULD opens an inaccessible 
channel. 
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Moreover, there may be a certain number of pro- 
blems when compiling. Indeed, in S*basic, one 
can practically not use the DR_PPOS command, 
as that would mean opening a primary window. 
But, as we have seen, window #0 of S*basic 
should be the primary window for the S*Basic 
job, and a job cannot have two primary windows. 
Channel #0 was made the primary window with 
the OUTLN command. Thus, in interpreted basic, 
you will rarely use the DR_PPOS keyword. 


There are two consequences to this: 


First, if the program is to be compiled later on, 
one should include some lines along the follow- 


ing: 


IF compiled 

OPEN#1, "CON_" 

DR_PPOS (parameters) 
ELSE 

DR_PULD (parameters) 
END IF 


Thus, you open a channel #1 (which for nearly all 
commands is an implicit channel) in a compiled 
program, and then you open a primary window. In 


interpreted Basic, you open a secondary window. 
Second, there may be a positioning problem 
when displaying secondary windows: indeed, like 
for primary windows, the positioning of the se- 
condary window is achieved via the xpos% and 
ypos% parameters, which were described above. 
However, for secondary windows, these parame- 
ters contains the true coordinates (no muckling 
about with the pointer position here) where the 
window will be displayed. This however means 
that you cannot know where within the primary 
window the secondary window will open - the 
user may have moved the primary window from 
its original position. 


Of course, there is a solution, as you can use the 
pointer positioning. If xpos% and ypos% are given 
as -l, the secondary window will open at the 
pointer position. You can thus set the pointer 
within the primary window to a certain position 
and then open the secondary window. 


Ok, this is it for this time - in the next instalment 
we'll cover changing a window once it has been 
displayed. Is there anybody out there reading this 
series at all? 


3D Perspective Animation 


- Part 3: Trees 


Stephen Poole 


output. So | had to write my 
own method from scratch, and 
decided to draw bifurcation 
diagrams viewed at an angle, 
with leaf-production by random 
plotting, and the result was 
Satisfactory enough for my 


In QL Today of march 2003, | 
mentioned trees as part of 3D 
Perspective Animations, but 
omitted the code to draw 
these from the article. This 
article will set that right. First of 
all, | must apologise to readers 
for not having divided my vari 
ous 3D programs into modules, 
which would have meant less 
typing each time. This is be- 
cause | did not expect to print 
sO many articles from the start, 
otherwise | would have plan- 
ned things out better Mea 
Culpa! 

In 1988, a french magazine 
printed an article entitled ° 
Growth of Plants’ for the Atari 
ST This ‘interesting’ program 
allows you to enter strings of 
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characters which control the 
mathematical properties of 
plant-growth, but, patently, the 
code doesn't work, even on 
the ST (| have probably lost 
hundreds of hours typing in 
programs from magazines that 
rarely work, even after a consi 
derable ammount of debug- 
ging. One wonders if the ma- 
gazines possess the necessa- 
ry computers to test them on. 
[Screenshot attached, to 
show that we run the pro- 
grams - Editor] But nowadays 
published programs are rather 
a rarity) | have also a book 
called ‘Patterns in Nature’ 
which describes plant growth, 
but unfortunately does not de- 
scribe the formula for graphic 


needs. For more details on 
simple binary-trees, see the 
forthcoming article in Quanta. 

This program has been event- 
ful for me as for the last 20 
years | have been working 
uniquely on a monochrome 
monitor So | promised Jochen | 
would link up my JS to our 
television set and experiment 
with 4 and 8 glorious colours 
(to improve the otherwise psy- 
chedelic output}. However, | still 
prefer the look of the trees on 
my monochrome monitor, as 4 
or 8 colours dont give suffi- 
cient graduations for my liking. 
No doubt GD2 is the answer.. 
Remember that these trees 
are flat, so they must be drawn 
at an angle. They could be 
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Im stillen Winkel 12 D-47169 Duisburg| 
Tel. 0203 502011 Fax 0203 502012 | 
http://smsq.j-m-s.com 


Updates, Updates... 


Well we're — getting 
closer now. It seems, | 
was a bit too optimistic, 
although the programs 
were more or less ready 
by the end of February. 
However, SMSQ/E is still 
changing (as you can see 
in Wolfgang's article in 
this issue), and we need 
to change the programs 
accordingly. 

| have collected update 
sheets at the various 
shows, and will inform 
everybody as soon as 
the updates exist via 
email. 
The prices are set as well: Except for QD and QSpread, all other updates will be : 
more or less free (provided, you own the ‘current’ version). This means, owners of 
QPC 2 V3 will get the update for free, whereas owners of V1 or V2 will pay the 
normal upgrade fee as before. 

There are still many things which need to be done (a new stand-alone WMAN and 
PTR_GEN is required, for example - for customers to run the products without 
SMSQ/E) but as most of you will have SMSQ/E we continue with the initial idea: you 
keep the old disk, and the new version will come on a new disk. 

Therefore, a very minor charge for disk, label and postage will be all that you need 
to pay for Updates of QPAC2, QPACi, WINED, FiFi, EPROM Manager, QMAKE etc. 
(we think it will work out to be about 1 EUR per disk incl. postage plus a basic 
2 EUR for package). QD and QSpread upgrade will be 15 EUR each. 

If you like, send in your masters now {as proof of purchase). You will get them back 
unmodified, plus the new version on a separate disk! 

Of course, a news mail will be sent to the newsgroup as soon as things will be 
finally ready. But it is really close, | hope ... and | am still hoping! 
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improved by tilting the bran- 
ches in the third plane, rando- 
mising their bifurcation angles 
and pruning branches. In na- 
ture, plant growth is deter- 
mined by hormones called 
‘Auxins’, which respond to gra- 
vity, light, moisture, temperature 
and the like, and which create 
the long, winding character of 
branches and roots as they 
respond to the different stimul 
of the environment, occupying 
as much vital space as possi 
ble. The code to simulate this 
is somewhat too long for here, 
and | have not perfected it suf- 
ficiently for the moment. From 
the last QL Today | see that 
Simon Goodwin is working on 
various vegetal growths, so 
maybe we may get some en- 
lightenment from him some 
time. The whole field is an in- 
terseting one. The present pro- 
gram works by setting-up a bi- 
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nary tree and then calculating 
the position of its branches in 
3D. Then the nodes are sorted 
into distance order and divided 
into distance ranges to allow 
colouring the branches and 
their associated leaves. Finally 
the whole lot is drawn from far 
to near and coloured using a 
select loop to allow stipples, to 
increase the number of ‘tints’ 
allowed. The leaves are there- 


110 REMark Tree_3D_bas by S.Poole. v23,10,91 v22,06,03. 
120 REMark EXEC under SMSQ/E, or LRUN under QDOS. 

130 CLEAR: FOR md=4,8: MODE md: Demo 

140 INK 7: MODE 4: WIV: QUIT: REMark use STOP for QDOS. 


150 : 
160 DEFine PROCedure Demo 


170 REMark Can draw trees from any viewpoint using FOR loop: 
180 leaf=1: ps=20: rs=40: SLP=0: sh=6: ngl=36 


190 FOR FRONT=45,60 


200 focalise: init_tree 
210 FOR f=2 TO nb: pointem: classem 
220 sortem: rangem: CLS: fillem: i$=INKEY$(#1,999) 


230 END FOR FRONT: PAPER#2,7: INK#2,0: INK 0,4,0 


240 END DEFine 
250 : 


260 DEFine PROCedure draw_branch 


270 LOCal f: REMark Fill the Branches: 


290 


280 REMark Improve by Ranomising branch angles and pruning: 


300 Wx=x2-x1: Wy=y2-y1: wr=SQRT((Wx°2)+(Wy “2)) 

310 Wa=DEG(atan_(Wx,Wy)): Wt=wr/tk 

320 LINE x1,y1 TO x2,y2: FILL 1: LINE xl,yl1 

330 TURNTO Wa-90: MOVE Wt: TURN 90: MOVE wr 

340 TURN 90: MOVE Wt*2: TURN 90: MOVE wr: TURN 90: MOVE Wt 


350 FILL O: IF leaf=0: RETurn 


360 : 
370 REMark Draw leaves: 
380 FOR f=1 TO ps*2 


390 rr2=RND(—ps TO ps)/512: rr3=RND(-ps TO ps)/512 
400 xB=x2+rr2: y3=y2+rr3: POINT x3,y3,x3+3E-3,y3+3E-3 


410 END FOR f 
420 END DEFine 
430 


440 DEFine PROCedure V(vx,vy,vz) 


450 REMark Calculate the 3D Perspective Coordinates: 


460 lx=vx-tx: ly=vy-ty: lz=vz-tz 
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for stipple-blocks, printed in a 
random range around the node. 
To animate this code, it must 
be incorporated into Part 1 or 2 
of this series. This 3D program 
is the last | shall be printing, as 
further 3D-Animation demands 
enormous quantities of DATA 
entry, but | hope readers have 
enjoyed seeing what can be 
achieved on a humble 20-year 
old QL. 
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470 lh=SQRT(1x“2+ly 2): lr=SQRT((1h°2)+(1272)) 
480 h=atan_(ly, 1x)-c: IF h>PI: h=h-r360: END IF : IF h«=PI: h=h+r360 
490 e=atan_(1z,lh)-b: IF e»PI: e=e-r360: END IF : IF ec—PI: e=e+r360 
500 mm=TAN(h): nn=—1*¥TAN(e)*SQRT(mm*2+1) 

510 END DEFine 

520 : 

530 DEFine FuNction atan_(oo,aa) 

540 REMark This overcomes the ATAN limitations: 
550 so=(00.0)-(00<0): sa=(aa>0)-(aac0) 

560 IF so»—1L AND sa=0: RETurn 0 

570 IF so=0 AND sa>0: RETurn r90 

580 IF soc0Q AND sa=0: RETurn PI 

590 IF so=0 AND sac0: RETurn r270 

600 oa=ATAN(aa/oo) 

610 IF so.0 AND sa>0O : RETurn oa 

620 IF socO AND sac>O: RETurn PI+oa 

630 IF so.0 AND sacO : RETurn r360+oa 

640 END DEFine 

650 : 

660 DEFine PROCedure sortem 

670 LOCal nr,pt,Q,LL,SL, ri, SR 

680 REMark Uses the RADIX-sort: 

690 nr=0: pt=1 

700 REPeat Q 

710 pt=ABS(pt): kk=k(pt, bk) 

720 IF ((kk&> 0)-(kk«0))<O : pt=kk: NEXT Q 

730 LL-k(pt,dw): SL=(LL0)-(LL« 0) 

740 IF SLO: k(pt,dw)=-LL: pt=LL: NEXT Q 

750 ri=k(pt,Up): SR=(ri>0)—(ri« 0) 

760 IF SR<O: k(pt, bk)=-kk: NEXT Q 


770 : 

780 IF SL=0 THEN 

790 IF SR=0 THEN 

800 : 

810 IF test(1) THEN 

820 RETurn 

830 ELSE k(pt,dw)=_a: k(pt,ri)=_a: k(pt,bk)=—kk: pt=kk:NEXT Q 
840 END IF 

850 : 

860 IF test(1) THEN 

870 RETurn 

880 ELSE k(pt,dw)=_a: k(pt,ri)=_a: k(pt,bk)=-kk: pt=kk:NEXT Q 
890 END IF 

900 END IF 

910 ; 

920 IF SRO THEN 

930 IF test(1): RETurn :ELSE k(pt,dw)=_a: k(pt,Up)=-ri: pt=ri:NEXT Q 
940 END IF 

950 END IF 

960 : 

970 IF SL<O THEN 

980 IF SRO: IF test(1): RETurn : ELSE k(pt,Up)=—ri: pt=ri: NEXT Q 
990 IF SR=0: IF test(1): RETurn : ELSE : k(pt,ri)=_a: pt=kk: NEXT Q 


1000 END IF 
1010 END REPeat Q 
1020 END DEFine 


1050 DEFine FuNetion test(_) 

1060 REMark Escape if this is the last node: 

1070 IF pt«o1 THEN 

1080 nr=nr+1: k(nr,tl)=pt: k(nr,st)=-k(pt,br): IF nr=nw-1: RETurn 1 
1090 END IF 

1100 RETurn 0: END DEFine 


1120 DEFine PROCedure focalise 

1130 REMark Set up reference viewing line once and for all: 

1140 OPEN#1,con_32: OPEN#2, con_32 

1150 PENDOWN: QZ=rs*TAN(RAD(SLP)): ang=FRONT 

1160 r90=RAD(90): r180=PI: r270=RAD(270): r360=PI¥2: ac=512: dn=256 
1170 WINDOW ac,dn,0,0: PAPER 2,0,3: INK 0,4,0: IF md=8: PAPER 1,0,3 
1180 WINDOW#2,512,206,0,0: INK#0,7: PAPER#2,0: INK#2,7: CLS 
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1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
1460 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1560 
1570 
1580 
1590 
1600 
1610 
1620 
1630 
1640 
1650 
1660 
1670 
1680 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
4880 
1890 
1900 


sey=.5: sex=.75*scy*(ac/dn): SCALE scy,scx/-2,scy/-2 
ex=0: cy=0: cz=0 


tx=(rs*SIN(RAD(ang-180)))+ex: ty=(rs*COS(RAD(ang-180)))+cy: tz=Q2 


fx=cx-tx: fy=cy—-ty: fa=cz—tz: fh=SQRT(fx 2+fy 2) 
c=atan_(fy, fx): b=-atan_(fz, fh) 
END DEFine 


DEFine PROCedure ajust_quarters 

REMark Keep angles within +/-— 90 degrees: 

IF f=2: kp=0 : kt=r90-a: GO TO 1340 

IF f=3: kp=PI: kt=r90-a: GO TO 1340 

IF rst=0: kp=k(o,p)+RND(a): IF kp» =r360: kp=kp—r360 
IF rst>0: kp=k(o,p)-RND(a): IF kp<0 : kp=kp+r360 
IF rst=0: kt=k(o,t)+a2 

IF rst.0: kt=k(o,t)-a2 


IF kt»r90 : IF kt«PI : kt=PI-kt : kKp=kp+PI 
IF kt» PI : IF kt<=r270 : kt=(kt-PI)*-1 
IF kt=PI : kt=0 


IF kt>r270 : IF kt<r360 : kt=(r360-kt)*-1: kp=kp+PI 
IF kt«-r90 : IF kt»-PI : kt=(kt+PI)¥-1 : kp=kp+PI 


IF kt=-PI : kt=0 
LF kt<-PI : IF kt>=-r270: kt=(PI-kt)*-1 
IF kt<-r270: IF kt»>-r360 : kt=r360+kt : kp=kp+PI 


IF kt<O: kt=kt+r360: END IF : IF kt>=r360: kt=kt-r360 
END DEF ine 


DEFine PROCedure init_tree 

REMark SET up Arrays with Indexes: 

FILL 0: mx=9999: a_=mx+1: _a=-a_: rt=0: DIM Rg(7) 
a=RAD(ngl): nb=((2°sh)*2)-1: wds=nb-1: nw=nb: rf=(sh-1)/sh 
xX=1: y=2: 2=3: r=4: p=5: t=6: m=7: n=8 

d=9: br=10: tl=11: st=12: dw=13: Up=14: bk=15: ik=16 

DIM k(nb,16): f=1: k(f,x)=0: k(f,y)=0: k(f,z)=-3: a2=a*.7 
k(f,r)=3: k(f,p)=0: k(f,t)=r90: V k(f,x),k(f,y),k(f,2) 
k(f,m)=mm: k(f,n)=nn: k(f,d)=lr: k(f,br)=1r: k(f,t1)=0 

END DEF ine 


DEFine PROCedure pointem 

REMark Calculate nodes: 

o=INT(f/2): kr=k(o,r)*rf: kp=k(f,p): kt=k(f,t): rst=f MOD 2 
ajust_quarters: ck=COS(kt) 

k(f,r)=kr: k(f,p)=kp: k(f,t)=kt: k(f,x)=kr*ck*COS(kp)+k(o,x) 
k(f,y)=kr*ck¥SIN(kp)+k(o,y): k(f,2)=kr*SIN(kt)+k(o,2) 
V k(f,x),k(f,y),k(f,z) 

k(f,m)=mm: k(f,n)=nn: k(f,d)=lr: k(f,br)=(1r+k(o,d))/2 
END DEF ine 


DEFine PROCedure classem 
pt=1: REMark Presort the nodes: 
REPeat Q 


zizdw+(k(f,br)>k(pt, br) ) 
IF k(pt,zi)=0: k(pt,zi)=f: k(f,bk)=pt: EXIT Q 
pt=k(pt, zi) 

END REPeat Q 

END DEF ine 

DEFine PROCedure rangem 


REMark Select colour depths: 
minD=k(1,d): maxD=minD 
FOR f=1 TO nb 
IF k(f,br)<minD: minD=k(f,br) 
IF k(f,br)»maxD: maxD=k(f,br) 
END FOR f 


REMark Set range colours: 

rge=(maxD-minD)/7 : Rg(1)=rge: Rg(2)=rge+minD 
Rg(3)=(rgeX2)+minD: Rg(4)=(rge*3)+minD 

Rge(5)=(rgex4)+minD: Rg(6)=(rge*5)4+minD: Rg(7)=(rge*6)+minD 


REMark Set the monochrome leaf colours: 


FOR f=1 TO nb 
FOR j=1 TO 7 
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Think your own thoughts. 
Q60. The Super QL. 


Features 
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x New ,ShoeString* Q60 Linux distribution 


Q60/60 & Q60/66: 68060 CPU, 60/66 MHz, MMU+FPU 
Q60/80: 68LCOG60 CPU, 80 MHz, MMU (no FPU) 

68060 superscalar architecture, dual execution units 

Up to 160 BogoMIPS performance for Q(DOS+SMSQG/E 
16 to 128 MB RAM, PS/2 module sockets 

256 kB ROM (mainboard supports up to 1024 kB) 
Highspeed 32 bit graphics + original QL hardware modes 
Up to 65536 colours at 1024 x 512 pixel resolution 
Multisync monitor output (15 pin HD connector) 

PC Keyboard interface (DIN) 

20 kHz Stereo sound 

Battery buffered clock, 2 KB nonvolatile RAM 

Controller for 2 floppies and 2 IDE harddisks or CDROM 


2 Serial ports with 115200 Baud, Parallel port (on {/O 
card supplied with mainboard) 


Hardware extension slot supports ISA cards 

Fits directly into AT Minitower or other standard case 
+5V / +12V power supply 

No tinkering, no parts from original QL needed 
Mainboard size 8.2 x 6.3 inch 

Can boot in a few seconds, directly from ROM 


Runs three different operating systems: 
SMSQ/E, QDOS Classic and Q60 Linux 


Complete Systems 
Q60/60 Midi Tower* 
68060 @ 60 MHz, MMU+FPU, 
64MB RAM, CD-ROM 56x, 
3.5” Floppy, 20 GB Harddisk, 
Keyboard, 3 Button Mouse, . 
2 SER, 1 PAR, Stereo Sound £ 545.00} 
Higher mainboard spec. ' 
Q60/66 (68060, 66 MHz) 


Extras 

RAM 

16 MB (giving 80 MB) 

64 MB (giving 128 MB) 

/O Card (FLP,IDE,SER,PAR) 
Floppy disk drive 

Operating System 

OS programmed on ROMs** 
Q60 Linux CD 

Ethernet Card 10 Mbit/s 
Stereo speakers 

3 boxes, including sub-woofer 
Preinstalled software package 
QPAC1, QPAC2, FiFi, QD, 
PROWESS and much more, 
over £100 worth 


+ £139.00 | 


£17.00 | 
£36.00 | 
£14.00 | 
£11.00} 
£10.00 | 
£15.00 | 
£17.00 | 


£ 19.00 | 


£59.00 | 


* Fully assembled and tested! Includes support disks and manuals. 

™ SMSQ/E and QDOS Classic available 

Shipping and handling is extra. Prices may change due to semiconductor costs or exchange rates. Please 
note: Current SMSQ/E version supports only 16 MB out of 64 MB RAM, or 32 MB out of 80/128 MB RAM. 
Linux fully supports all memory configurations. 


Website and technical information: 


www.q40.de 
Email: info@q40.de 


D&D Systems 


P.O. Box 5813, Ripley, Derbyshire, England DE5 9ZR 
Tel. +44 (0)1773-740170, FAX +44 (0)1773-748399 
After sales Tel. +44(0)1773-741 164 (evenings) 


Email: sales@q40.de 
Financially assisted by a loan from QUANTA 


Take the power back in your hands. 
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1910 IF k(f,br)>=Re(j): k(f,ik)=8-j 


1920 END FOR j 
1930 END FOR f 

1940 END DEFine 

1950 : 

1960 DEFine PROCedure fillem 


1970 tk=30: REMark Draw_branches: 


1980 FOR f=nb TO 1 STEP -1 


1990 j=k(f,t1): o=INT(j/2): Kl=k(j,ik) 
2000 SELect Kl 

2010 =1: INK 0,4,0 

2020 =2: INK 0,4,3 

2030 =3: INK 4,0,0 

2040 =4: INK 4 

2050 =5: INK 4,0,3 

2060 =6: INK 4,6,0 

2070 =7: INK 4,6,3 

2080 END SELect 

2090 xi=k(o,m): yl=k(o,n): x2=k(j,m): y2=k(j,n): draw_branch 


2100 END FOR f 
2110 REMark Draw Trunk: 


2120 f=1: V k(f,x),k(f,y),k(f,2)-k(f,r) 
2130 xi=mm: yl=nn: x2=k(f,m): y2=k(f,n) 
2140 INK 4,0,3: tk=20: draw_branch 


2150 END DEFine 
2160 :: 


My first QL show (ever) 


Phoebus Dokos 


Last year during the traditional 
gathering at Bill's house | was 
asked by Al Boehm, if | was 
going to attend the 2003 US 
show. | told him that as long as 
it fell within a certain time peri- 
od | would as the previous 
years it had always fallen du- 
ring the time | was either on my 
way to or in Greece at the time. 
True to his word (and after a 
small tug-of-war regarding 
dates in ql-users) Al set the 
show for a favourable time for 
me (and | hope for everyone 
else but more about that later). | 
was very pleased that my wife 
decided to come along (mainly 
because she wanted to see 
Mary and Dorothy again whom 
she met at Bill's house that past 
October - And it was ALL Bills 
fault.. people who know will 
understand what that means'). 

The trip was rather uneventful 
although very tiring as | keep 
forgetting (even after 4 years in 
the US) that miles don't equal 
kilometers and what seemed a 
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Short trip (398 miles) was actu- 
ally an 8 hour drive. Our little 
(fully loaded with QL stuff and a 
19” monitor) Echo (It's a non- 
hatchback Yaris as it's known in 
the rest of the world) fared 
pretty well and a little after 
10pm on Friday we were there. 
We ran into Bill, Mary and Rigel 
together with Kevin O'Leary 
and Herb Schaaf (whom I've 


admired for a long time for his 
broad knowledge... the fact that 
he's applying it to graphics 
helped too!). Jochen, Roy and 
Marcel as well as Al and 
Dorothy weren't there yet and 
since our stomachs were 
growling we went with Michelle 
(my wife) to a local Denny's to 
eat. On the way back we saw 
Al and Dorothy and | was intro- 
duced to Dietrich Buder. 

Next morning going for (as Roy 
very well put it last issue) to 
what EconoLodge considers a 
breakfast we saw the Euro- 
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pean “team” assembled in full. 
Roy, Marcel and Jochen were 
there (who was taking pictures 
with his superb Nokia phone 
that got me so jealous | just 
ordered it!), together with Roy's 
son and Urs Konig. The party 
was completed with Bill, Al, 
Kevin, Mel LaVerne, Herb 
Schaaf and Jon Kaczor The 
ladies together with Bill's and 
Roy's sons left for a tour of 
West Haven and shopping 
and we proceeded to the 
large room that Al had 
arranged on the third floor 
and set up our machines. | 
had brought my PC and my 
dual Q40 and Aurora machine 
(complete with the GD2 
version of SMSQ/E 3.00). 
There was another Q40 
there by Kevin O'Leary and 
three more SuperGoldCard 
Powered Auroras: One 
Towered-Cased (Mel 
LaVerne's), one in a Pandora 
case (Al Boehm's) and the 
Pizza-Layout as | call it (see 
description by Roy in previous 
issue) of Herb Schaaf's. Roy, 
Jochen and Marcel had their 
QPC2-enabled PC notebooks 
as well. 

Immediately the QL-spirit took 
over as while trying to demon- 
strate SMSQ/E v3 with GD2 on 
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the Aurora we immediately 
found out that no machine ex- 
cept mine was working! It turns 
out that the problem wasn't on 
SMSQ/E but on the setups as | 
experienced the same exact 
problems once | put my QubIDE 


to work. Timing problems were 
the most likely culprit, but the 
end result was that | wasn't 
able to properly demonstrate 
how SMSQ/E looks with GD2 
on the Aurora, although Marcel 
with a quick hack created a 
version of the WMDEMOWIN 
file he has with QD, QSpread 
and QPAC || GD2 (with 3D 
WMAN) editions. 

Mel had an additional problem 
with his machine as his Miner- 
va’s battery died and as a re- 
sult no booting was possible. 


We temporarily fixed the pro- 
blem by substitution of his MkKIl 
(On carrier) with a JM rom | had 
with me. We stopped and went 
for lunch at a nearby Pizza-Hut 
(which awed me as it served 
beer which is something that 
you Cannot see in Pennsylvania 
where | live - you can tell that | 
don't get around much!). There 
we had the usual fun with Mar- 
cel getting carded and giving 
the waitress his German ID 
(more on that fun below as 
well) and | got to talk to Jon a 
little bit while we were both 
outside having a puff or two! 
Upon our return, Roy phoned 
Jim and they conducted a "re- 
mote’ demonstration of the ve- 
ry impressive QDT. Immediately 
afterwards | performed a demo 
of Q-Word running on my Q40. | 
was very pleased that ever- 
yone seemed to like my gra- 
phics (although | don't know 
| if they were just being nice). 
| also demonstrated QL2K 
the new QLAY port by 
Jimmy Montesinos running 
under Windows) and even 
used my Tyche ROM on it. 
- Throughout the day a little 
trading took place as Roy 
— updated QublDE roms (I got 
a set of gals) and programs, 
_ while Marcel and Jochen 
were busy updating 
software (and making some 
sales as well from what | 
could see). | gave away some 
used stuff and also discussed 
the possibility of a couple Q60 
sales. Unfortunately due to the 
problematic phone installation | 
was not able to demonstrate 
sSOQL-PPP and the QL emailer | 
did however gave a couple of 
copies away and | hope that 
after some supporting soft- 
ware is completed, QL internet 
usage will take off! 
The show came to an end 
around 5 and we went on to a 
Mexican (sort-of) restaurant. | 
won't expand too much but 
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to be rather entertai- 
ning as we all took 
one car (mine!) which 
wouldn't be too much 
of a problem except 
that it is rather small 
for 6 people! We en- 
joyed the climate and 
had fun watching the 
local (drunk) crowd. 
We turned in around 
2 o'clock ready for 
an early start next 
* morning. 

| was delighted to 
meet old _ friends, 
make new ones and 
meet people with 
which | corresponded 
for years without 
ever meeting face to 
face. Truth be told 
however | was very dissap- 
pointed by the poor atten- 
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suffice it to say that | thought 
Greeks had the worse restau- 
rant service in the world. Well 
after a 3 hour wait to be + 
served my opinion changed! At 
least the drinks were flowing 
and it was fun watching the 
waiters and waitresses trying 
to understand Marcel's ID (They 
seemed very puzzled my the 
month/day/year concept). That 
made for a couple of laughs 
and thanks to the good com- 
pany time passed a little easier 
Bill, Kevin and Al had to leave, 
Dietrich couldn't take the wait 
so he had gone earlier and Urs 
left as well, so me, Michelle, 
Roy, Marcel, Jochen and Roy's 
son decided to go out to have 
a couple of drinks. That proved 


dance. Counting myself out (as 
| really don't fit anywhere ;-) 
there were only 6 people from 
the US attending the show! 
Not only that but if Tony and 
Darren had made it over this 
time the Europeans (or rather 
the traders) would be more 
than the customers! A lot of 
careful planning should go in 
the next show and maybe the 
next should be set to Europe 
as it would give an extra incen- 
tive to make the trip for people 
that did not attend. Personally 
for me it was worth the time 
and the cost but if the trend 
continues | am not sure how |o- 
gical it would be to do it a 
couple more times. I'd rather 
attend a German or British 
show (or the Irish show.. hic!) 
and see more people and at 
the same time travel a little bit. 


QPC2 Version 3.11 


Dilwyn Jones 


QPC is a QL Emulator running on PCs with Win- 
dows 95 or later Having started life as a DOS- 
based emulator, QPC has gone through many up- 
dates and upgrades in its life, thanks to the de- 
dication of its author Marcel Kilgus, who has 
always been prepared to examine new possibill- 
ties and constantly strived to improve the 
product. 
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've used QPC almost since it first came out. At 
the time, my need for a PC as well as wishing to 
reduce the amount of computer hardware (or 
“junk” as my wife called it) around the house 
made a good QL emulator running on a PC an 
ideal choice for me, especially as it used the 
SMSQ/E operating system, and | have kept up to 
date with it as the various versions came out 
overthe last couple of years. So | thought that 
with the advent of SMSQ/E 3, the new Window 
Manager and everything else in the latest 
version, I'd look back at the history of QPC a bit 
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and take a good long look at the latest version 
as well as how the emulator developed. 

QPC uses the SMSQ/E variant of the QL opera- 
ting system. SMSQ/E was Tony Tebby's develop- 
ment of a brand new operating system for QL 
platforms, originally implemented for QXL, Atari 
ST and Ql-based platforms. During the life of 
SMSQ/E it migrated to the Q40 and Q60 compu- 
ters, and Marcel Kilgus implemented it for Win- 
dows systems via the QPC emulator SMSQ/E 
gave users of QL-compatible systems such as 
Auroras, QXLS and so on the opportunity to 
experience much higher display resolution than 
the original QL 512x256 pixel resolution. In fact, 
the opening QPC configuration dialogue screen 
lets you specify resolutions up to 1600x1200 if 
your system permits this! | wonder how readable 
CSIZE 0,0 text would be on a 1600x1200 
screen? This configuration screen lets you type in 
your own resolutions rather than just select the 
fixed ones from the menu, so you can create 
some custom screen sizes if you really wish to. 
Normally | just VGA or SVGA (640x480 or 
800x600 pixels) though | do sometimes set 
custom screen sizes just to test software. 

QPC2 is very flexible in terms of how much of 
the PC resources it will help itself to. You can set 
QPC to use anything from 1 to 128MB of memory. 
If the PC does not have enough memory, QPC2 
seems to use ‘virtual memory’ on the PC's hard 
disk. This seems to slow things down a litle bit, 
due to the constant writing to hard disk, but to an 
acceptable degree. 

It used to be the case that large memory sys- 
tems like QPC2 suffered in speed terms a little 
bit due to a side effect of QL slave block hand- 
ling. When the QL first came out, it had micro- 
drive tape cartridges and in order to speed 
things up some spare memory was used to 
mirror the content of microdrives. This has re- 
mained integral to the operating system to this 
day, despite the advent of fast hard disks and so 
on which in theory make this less necessary. 
Somewhere in the lifetime of QPC2 Marcel Kilgus 
has implented a system whereby slaving only 
applies to a certain portion of memory, probably 
along the lines of the old "Fast Memory” system 
of the Atari emulator systems. It does have a side 
effect of distorting the free memory values re- 
turned by some functions which test free me- 
mory, although the Toolkit 2 and SBASIC 
FREE_MEM function does return a correct value 
which compensates for this. 

Marcel also took the opportunity to take advan- 
tage of certain facilities available to this platform, 
probably the best known of which was audio CD 
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handling. For possibly the first time on a QL 
system, it was possible to play music CDs, and 
Marcel even built in BASIC extensions allowing 
you to access these facilities in your own 
programs - a CD player program was supplied 
written in SBASIC. SMSQ/E has always been 
supplied with SBASIC, a much enhanced version 
of the original QL SuperBASIC. SBASIC fixed 
many problems with SuperBASIC, programs ran 
very much faster than SuperBASIC and the 
language itself was greatly enhanced, providing a 
large number of extra commands and functions. 
In particular you could in fact have multiple 
SBASICs and even EXEC an SBASIC program 
alongside the main SBASIC interpreter. 

With version 2 of QPC came the long-awaited 
“colour drivers’, more correctly known as the 
GD2 system. QPC2 now offered the joys of 16-bit 
colour a full 65,536 colours accessible from 
SBASIC. QPC could be run in a Windows window 
now, rather than have to occupy the full screen. It 
was even possible to ‘stretch’ the display if 
required by taking advantage of graphics card 
facilities available to the underlying operating 
system of the PC. And taking this a step further, 
there is also an option in the configuration screen 
to allow the display to be stretched and keep the 
aspect ratio - it will stay the same shape as you 
stretch the display, 

Multiple language facilities were available now, 
and QPC itself could be configured for French, 
German or English operation, with the additional 
option of American keyboard layouts which 
proved rather useful for those of us in Britain 
using laptops, since the USA keyboard option 
provided the best keyboard layout options for 
laptops. Power management facilities are 
available to QPC users, again very useful for PC 
systems such as laptops. 

SMSQ/E floating point functions took advantage 
of the PC’s Floating Point Unit (FPU), providing 
significant speed up for mathematical operations. 
The printing system was also enhanced. Rather 
than being a pure PAR printer port as we were 
used to, the PAR device could now be connec- 
ted directly to a Windows printer, so that network 
printers could be used. In the office where | 
worked at the time, | could run QPC2 from a CD 
on the office PC and print to the high quality 
laser printer on the main computer in the mana- 
ger's office. In fact, multiple parallel and serial 
ports can be accessed in current versions of 
QPC2, see Figure 7 for how QPC2 sets up the 
assignments of up to 4 parallel ports and up to 8 
serial ports. My PC has “only” 4 serial ports and 1 
parallel port, but the parallel port has a daisy 
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Text 87 PROGRAMMING 


QD 2003 £ 49.00 

QD + QBasic £ 63.00 

QD + Qliberator + QBasic £ 104.00 
Fountext 94 £ 39.00 Qliberator £50.00 
2488 drivers £ 29.00}] Master Spy v3.3 £ 30.00 
Epson ESC/P2 driverq | QPTR £ 32.00 


£ 26.00 Easyptr pt 1 & 2 (together) £ 30.00 

Text 87 is the only QDOS Easyptr pt 3 (C library) £ 14.00 

/ SMSQ wordprocessor QM ake £18.00 

capable of handliing the QMon /JMon £ 22.00 
full screen on the Aurora pines i, 

/ QXL/QPC systems. New] | Basic Linker £ 22.00 

drivers are currently DISA 3 £34.00 


being written. QM enu £ 16.00 


Apology for the Delay 


Some of you may have been wondering why the upgrades that you ordered 
have not been despatched. This is because there have been a _ couple of 
holdups in producing peripheral files for non SMSQ/E users. We are _ hoping 
that these will be released soon and then the full release disks will be made 
available to QBranch and despatched to you. 

There is also a problem that has been isolated in SMSQ/E v 3.01. This has 
been corrected and is in the testing stage as we go to press. People who 
have ordered upgrades to this will receive their disks as soon as the new 
version is available. 


These programs are free upgrades : 
(Just send 75p for the disk and 80p postage + master as proof of ownership) 
Agenda 


QMake These Programs are paid Upgrades: 
Wined 
Fifi It QSpread 2001 to 2003 £ 10.50 
QPAC 1 QD 98 to 2003 £ 10.50 
QPAC 2 QPC2 - 
QSup update from v3.xx Free 
All versions of _update from v2 £ 13.90 
SMSQ/E(Gold Card/QXL/Q40 (update from vl £ 34.00 
With Order 


ipdate from 
QL Keyboard Membranes <tr Sit! 


i ' 
- sa ae ‘Pep | Just Words' by Geoff Wicks 
- THESAURUS, STYLE CHECK 


£ 10.00 ea / ANY 2 PROGRAMS £ 18.00 / ALL 3 PROGRAMS £ 25.00 
UTI LIT] E S (Includes Pointer and non-pointer driven versions) 
FiFi 2 £ 21.00 


( P.E. versions need Hot_rext, WMAN and PTR_GEN or SMSQZE to run ) 
Upgrades from previous versions £ 2.50 + S.A.E. New Manuals £ 1.50 


QSup £30.00 

QSpread 2003 £51.00 QL2PC { 
Cueshall2 £15.00 Convert text files from QL to PC formats uppot : 
Qload/Qref £15.00 and much more ! pT * 


Only £10.00 now 
QL Rhymes ¢ 10.00 
Rhyming Dictionary 


Spelling Crib : PD program £ 1.50 +SAE 
or Free if you buy all three programs 


Disk Mate 5 £ 16.50 
QPAC 1 £ 22.00 
QPAC 2 £ 42.00 
QTYP 2 £31.00 
QLQ £ 30.00 
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| Tel +44 (0) 1273-386030 fax +44 (0) 1273-430501 


| Mobile +44 (0) 7836-745501 
\. email qbranch@qbranch.demon.co.uk web : hitp:/Aw).gbranch.demon.co.uk —_ ge 


QO Branch 


Feeling out o a Hie ? 

Reach out for Q Branch. 
Suppliers of Quality (DOS/SMSQ products 
Hardware and Software. 


Hardware 


We have a small stock of second user items. Auroras / 
Qubides / Gold Cards / Qplanes / superHermes etc. call 
20 LOCKS HILL, PORTS LADE, us to get details of the items available. These are going 


E. SUSSEX. BN41 2LB. UK. fast so call soon. 


QXL II £ 100.00* 
Recycled superHermes £ 65.00 * 
Recycled Gold Card £ 45.00 * 
Recycled Aurora £ 70.00™ 
Qubide £50.00* 


ProWesS 


ProWess (now free !) £1.60 
DATAdesign £ 20.00 
Fontutils £ 28.00 
File Search £11.00 
PFlist £11.00 
Dilwyn's Fontpack £ Call 


Qplane £ 5.00 

Aurora cables £3.00 
Aurorarom adaptor £3.00 
'‘Arfa Braquet’ £ 8.00 
‘Son of Braquet' £18.00 
The 'Braquet' £ 16.00 
MC plate £ 6.50 


* when available. 


LINEdesign v 2.16 £ 22.00 
PWfile £17.50 


Paragraph 


The ProWesS word processor 
Demo version £ 1.50 + postage 
Full Registered version £ 18.00 


{ 
rsion. 2.03 available now : 
e 


Qubide upgrades to version 2.01 £ 8.00 


SMSQ/E Now Only £ 32.00 


Gold Card / Atari / QXL Version Various Atari versions : call for details 


QPC 2 v3.10 full colour version! 
Special offer ! Now Only £ 65 00 


Get Cueshell for only £15.00 with any copy of SMSQ/E 
or QPC 2 upgrade ! 


Q Branch Programs 


The Knight Safe 3 £35.00 Q- Route v1.08C £25.00 


upgrades from previous versions £5.00 Route finding peerenis 
Q - Count £25.00 The Fractal Collection £35.00 


Pointer driven home accounting 
Post and Packing is included with Software Prices 
Unless Otherwise Stated. 


We can accept payment by Visa, Mastercard and Switch. We also accept 
cheques drawn on a UK Bank in Sterling. 
You can also pay directly into our bank in Euros. 
Barclays Bank Acc# 79016888 sort code :20-71-02 Name :QBranch) 
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chained set of peripherals hanging onto it, inclu- 
ding scanner and Zip drive - amazingly, QPC 
seems able to access my printer and Zip drive 
even though they are both connected to the 
same port! In fact, just about anything which is 
seen as something having a drive letter (C\ to 
Z\) seems to be recognisable to some degree 
or other by QPC2, even some flash memory 
cards, USB peripherals and so on which appear 
as valid drives to Windows. Much was made of 
“device independence’ when the QL first came 
out 20 years ago, QPC2 takes all this even 
further! 

A very important development as far as | was 
concerned was the implementation of the DOS 
device driver This gave an easy method of 
accessing the PC hard disks and CD-ROM dri- 
ves. Utility software such as Jonathan Hudson's 
WXQT2 had previously been available to facilitate 
the transfer of files between the QL and PC 
parts of the computer but now for the first time 
there was a seamless method of transferring 
files between the QL and PC parts of the system. 
Copying a file from floppy disk to QL hard disk 
was as simple as COPY FLPt_file TO WIN1_file, 
but now you could copy to the PC hard disk with 
a simple command like COPY FLPi_filename TO 
DOSIi_filename. There was a restriction, namely 
that QL executable file headers were lost on the 
PC side of things, meaning that you could not 
Store QL programs on the PC side of hard disks, 
but apart from that, the facility to so easily move 
text and other data files so easily between 
platforms was one more giant leap forward for 
QL systems. SMSQ/E also had the capability of 
reading PC format floppy disks in QL drives with 
the level 3 filing system. 

The underlying Windows operating system had a 
cut and paste system called the Windows 
Clipboard. With this, text, graphics and all sorts of 
data could be cut or copied from one program, 
then pasted into another program. The original 
QL did not have this facility, but the Menu 
Extension software from Jochen Merz provided 
something called the Scrap system, which 
allowed programs such as QD and others which 
understood what it was (including BASIC with the 
appropriate extensions) to use a similar facility. 
QPC implemented something called 
QPC_SYNCSCRAP which allowed synchronisa- 
tion of the Windows and SMSQ/E clipboards - 
the means to copy data to one and have it 
available for pasting in the other - via a small job 
Started to deal with just this synchronisation. 
Again, a much appreciated facility for those like 
me who found it oh so useful. 
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By now QPC2 had progressed to version 3 and 
left some people wondering if this was QPC3 or 
QPC2? Marcel and Jochen's preferred descrip- 
tion was QPC2 v3 which in my opinion was a bit 
of a mistake, as the new version was such a leap 
forward that | felt it deserved a name which high- 
lighted the advance. After a while of complaining 
about the naming (which | felt quite strongly 
about) | gave up complaining and just accepted it. 
Nonetheless, the power management system, 
configuration system, multiple PAR ports and so 
on made a significant difference. A new approach 
for printing was allowing the PAR ports to have 
an "Use Filter’ option, which allowed third party 
print filters to be incorporated into the print 
process, although little use seems to have been 
made of this facility so far. 

The DOS device was enhanced to allow for the 
8 devices to be redefined. Instead of DOSI_ 
simply being the PC drive C:\ as before, it was 
possible for it to be just about anything you 
wished. The significance of this was twofold, 
apart from the flexibility it offered. By specifying 
a PC network filename, one of the DOS drives 
could be used to access a hard disk on another 
PC over the network, or a Windows path name 
could be ‘hidden’ in the drive name, giving a 
degree of workaround for the limitations imposed 
by QL 36 character filenames. In other words, 
DOSi_ need not be just drive CA it could be 
something like CAWindows\Desktop\ or some- 
thing similar, thus allowing names longer than the 
usual QL 5 character drive name plus 36 charac- 
ter filename. The extremely useful opening con- 
figuration dialogue could set and store the drive 
and path names for all 8 possible DOS drives. In 
addition, a degree of character translation was 
possible, such that some characters which are 
illegal in PC filenames such as * and ? to be 
converted to something else which doesn't 


WIN/FLP: configurat 


me PREC 

wing [CAqADUBNOXL aN 

“wine [RAenDODQMLWIN SD 
5 [CA@REMUGXLWIN SSS 


[EXoALITVGE WIN —— ne 
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upset the PC. See the pictures before and below 
for the window which allows you to specify 
exactly what WINi. to WIN8_ and DOSi_ to 
DOS8_ respectively are defined as. 


Another interesting facility introduced was the 
QPC_EXEC command. At first, | thought this was 
a bit perverse, since its function was to allow 
QPC to execute a DOS or Windows program or 
file. After a while | realised how useful this could 
be. | spend some time transferring files between 
QL and PC and it proved to be extremely useful 
if, for example, | created a text file on a QL then 
wished to make a PC version of that file as well 
I'd create the file on the QL, save it to a DOS 
device, then without leaving QPC | could fire up a 
PC word processor to load the file to check what 
it looked like! 

For older programs which did not handle higher 
resolution screens very well, or could not cope 
with system variables being anywhere other than 
the old standard QL location, QPC had a couple 
of major aids to compatibility built in. Firstly, by 
Starting QPC in 512x256 QL screen mode, this 
made the screen operation and system variables 
location more like the original QL, which helped 
with running ‘awkward’ programs. In addition, 
Marcel introduced the QPC_QLSCREMU com- 
mand. When emulating the original screen, all 
memory write accesses to the old QL screen 
area are intercepted and translated by QPC into 
writes into the appropriate areas of the larger 
QPC screen. If using high colour modes, some 
additional colour conversion work is done. | don't 
pretend to know how all this works, | leave the 
miracles to Marcel, all | do know is that it works 
and works well. 

By version 3.00, QPC could support wheel mice. 
These are a type of mouse which incorporates a 
little scroll wheel in addition to the usual mouse 
movement and buttons, though these types of 


QL foday 


mice could only be used in a standard way with 
versions of Windows from Windows 98 onwards. 
For SMSQ/E programs, the wheel movement 
was converted into meaningful keypresses (ALT 
up/down, useful in text editors for example). 
Version 3.02 introduced changes to the old BEEP 
emulation system, which used the rather basic 
built in speaker of the PC. This came about 
partly because versions of Windows based 
around NT (Windows 2000, XP and NT) seemed 
to have a problem with audio via the system 
speaker, so QPC2 users were unable to hear 
anything. The audio now used the Windows 
DirectSound interface, so that the QL BEEP 
commands came out of the sound card's 
speakers instead. When | first used this it was 
very LOUD, fortunately a degree of control over 
the volume has been built in from version 3.03, 
since on my system at least the BEEPs seemed 
louder than the standard ‘noises’ Windows 
makes. It was also important to me to have the 
volume control for QL beeps as my PC has a TV 
Tuner Card which | use quite a lot alongside QPC. 
With the emulator in windowed mode occupying 
about three quarters of the PC screen, | could 
watch TV in a smaller box alongside it - | am 
watching an episode of the Spooks program on 
BBC1 as | type this. At first, the QL beeps were 
so much louder than the TV audio that they 
made me jump, but once Marcel allowed the 
volume to be configurable, that changed. Of 
course, QPC sound output can co-exist with PC 
sound output, so you can hear TV tuner audio 
and QL BEEPs at the same time if the need 
arises. 

Version 3.03 also introduced DOS_DRIVE and 
DOS_DRIVE$ functions to allow the DOS device 
assignments to be changed on the fly rather like 
the WIN_DRIVE and WIN_DRIVE$ extensions did 
for the WIN device. | saw it as a kind of acknow- 
ledgement that the DOS device was sufficiently 
well used to justify the further development 
effort. 

Up until recently, version QPC2 3.03 was a stable 
and standard version for many users. | did much 
of my Launchpad development work on this ver- 
sion and the stability it offered me for a complex 
programming project was quite astounding. Had 
QPC2 developed no further | would have been 
quite happy, but no, Marcel had a few more tricks 
up his sleeve for when version 3.10 came out. 
Over the last few months, Marcel has been in- 
vesting a lot of time and effort in developing 
version 3 of SMSQ/E and the new Window 
Manager, plus developing colour drivers for the 
Aurora. The fruits of his labours are evident in 
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this new version of QPC. | won't go into too 
much detail about the new Window Manager, as 
much has been written about it already and it 
tends to get very technical. Suffice to say that 
the Window Manager helps provide the "standar- 
dised appearance’ of pointer driven programs, 
and the new Window Manager will better handle 
the facilities offered by GD2 and offer much 
better display appearances for programs able to 
take advantage of it. For example, you may have 
seen screen shots recently of updated QD, 
QPAC2 and Qascade programs, all nice new 3-D 
borders, transparent shadows, more colours and 
better icons than the old mode 4 and mode 8 
sprites could offer. 

In order to develop the 256-colour drivers for 
Aurora based computers, Marcel developed them 
in SMSQ/E with QPC. The result is an Aurora 
compatible 256 colour or 8-bit colour mode on 
QPC. When set to this colour depth, SMSQ/E 
returns 16 as the mode number. As yet, very little 
software makes direct use of this mode, 
although most software will run in this mode, 
since the colour scheme palette allows the old 
QL colours from 0 to 7 for example to corres- 
pond to colours 0-7 on the new scheme, there- 
fore there isn't any immediate and obvious large 
scale compatibility problem. You will, however, 
notice some less significant changes. The sys- 
tem pointer icons have changed somewhat and 
instead of a simple black and white pointer arrow 
you get a rather nice yellow and white shaded 
pointer arrow which looks rather nice and is more 
distinctive and easier to spot on screen than the 
old icon. The other system pointers have 
changed too (for the better!) 

The picture below shows the configuration 
screen in the current version of QPC, the item to 
select the new 8-bit colour mode being 
highlighted. 


36 


In addition to the existing printer port facilities, 
some new extensions have now been included 
to return information about names and types of 
parallel printer ports. There are extensions to tell 
you what the PAR port is set to, the number of 
available printers on this system and the name of 
a specified printer number. This does not make 
much sense until you start to use multi-printer 
and networked systems, but for those who do, 
these will prove very useful. 

Some new command line options have been 
made available in this version of QPC. When you 
start the QPC executable file, you can supply a 
short command after the name of the exe- 
cutable. Figure 2 shows what happens if you use 
the Windows RUN command to start QPC with 
the command -? after the filename of the QPC 
executable, i.e. 

RUN "c:\program files\qpc2\qpe2.exe" -? 


: -emidiine string . 


osfle 


While the picture shown above simply displays a 
short summary of the few available options, the 
Short list of currently available options does 
provide some useful facilities. 
The -os filename command tells QPC where to 
look for the operating system (the SMSQE.BIN 
file). While this is normally not very useful, the 
manual does cite one possible use, namely 
having as many differently configured QPCs in 
one directory as you want. So if the gamer in the 
household prefers to start QPC in 
Xi) QL compatible screen mode (since 
| most QL games were written back 
in the days of one simple QL 
system}, one copy of SMSQ/E 
could be configured for those set- 
tings. | tend to configure mine for 
640x480 VGA resolution, which 
leaves room on the screen for the 
TV tuner to run alongside it. Alter- 
| natively, as a software writer | could 
| have one copy of QPC set up to 
| start in QL colours, and other 
| copies set up to start in 8-bit colour 
; and 16-bit colour modes for soft- 
| ware development and testing. 
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Another available command option is simply to 
pass a string to QPC at startup with the 
command 

-emdline "text" 

As an example, let us suppose that you have one 
of those dinky little hard disk or flash ram cards 
on a keyring that you use to transfer QL data 
between home and the office. When plugged into 
your office PC's USB port, the little drive appears 
as drive F\, but on your home PC it appears as 
drive E\ Rather than configure differently, one 
option might be to pass a command line to QPC, 
then the boot program could set one of the DOS 
and WIN drives to that name as appropriate, so 
the office system might be started with: 

RUN "QPC2.EXE" -cmdline "F:\" 

and the home system with 

RUN "QPC2.EXE" -cmdline "E:\" 

The command line text could then be read using 
the QPC_CMDLINE$ function and used to set 
WIN3_ and DOS3_ for example: 

LET drive$ = QPC_CMDLINE$ 

WIN_DRIVE 3, drive$&'QXL.WIN' 

DOS_DRIVE 3,drive$ 


Version 3.10 of QPC2 was quickly followed by 
version 3.11, although | am not aware of any signi- 
ficant new facilities in this release, just a few im- 
provements and bug fixes to existing facilities. 

You will have read a lot recently about the new 
Window Manager which goes with the newer 
versions of SMSQ/E. One example of what is 
possible is shown in the screenshots below, 
which shows some of the available options when 
MenuConfig (the configuration program) is applied 
to QPC itself. The colour schemes have so many 
options | had to make two separate screen 
dumps to show all the options! 


IN case anyone is wondering how | captured 
these screen images from QPC’s display, | use 
the PrintScreen key on the QL keyboard. Used 
by itself, that captures a copy of the entire PC 
screen, whereas ALT PrintScreen simply cap- 
tures a copy of the current window, which has 
the advantage that | don't have to manually crop 
out all the PC bits around the edges of the QPC 
window! 

In case you haven't guess by now, | am one of 
the biggest fans of QPC2 you could find. That 
does not diminish my respect for other QL plat- 
forms of course - | had a Q60 on loan for a while 
and was absolutely delighted with that too, but 
space in my house did not allow for the two 
computers (and my financial budget didn't allow 
for a Q60 either), so as | needed something 
which offered both QL and PC in one box, QPC2 
has really proved its worth to me and | would 
have no hesitation in recommending it to anyone 
who requires a dual platform Windows and 
SMSQ/E system in one box. QPC2 is an emulator 
of course, rather than running as a native PC 
operating system, so it might be over-optimistic 
to expect an emulator to match the performance 
of a dedicated high end hardware QL system, but 
performance is more than adequate for my 
needs. And! am impressed with the way it works 
on my “ancient” (in PC terms, it's only a few years 
old actually) 333MHz PC, so | would expect 
absolutely blazing performance from it on some 
of today's fast PCs with clock speeds approach- 
ing 2GHz. 

You may find that some of the recent develop- 
ments in QPC2 may have become somewhat 
esoteric and too technical. That's fine, just don't 
use them. The facilities are there, you may only 
need to use a a small percentage of everything 
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QPC2 now offers, and you certainly don't need 
to master it ail in one go. 

The QPC manual was at version 2.06 as | wrote 
this review. | downloaded it as an Adobe Acrobat 
PDF files from Marcel Kilgus’s website. This only 
the QPC-specific part, of course, it does not 
include general SMSQ/E documentation which is 
supplied separately from Jochen Merz Software. 
As a registered user | was also able to download 
the latest QPC update from there. Registered 
users permitted to downloaded these updates 


Dev-C++/c68 


Simpifying code development for 
QDOS systems 
Phoebus Dokos 


1. Introduction 


One of the major problems QL developers are 
faced with is the lack of development tools avai- 
lable to many platforms. The problem is not really 
the lack of independent tools (languages, linkers, 
editors and other development utilities) but that 
these tools are apospasmatic at best without a 
proper environment to tie them all together and 
improve programming efficiency. While nothing 
can really substitute a native development envi- 
ronment, this issue can be to a large extent ad- 
dressed by a cross-development environment 
(such as Windows or Linux) where IDEs exist and 
are extensible enough to provide access to 
third-party compilers etc. | was faced with the 
same challenge many times in the past years, 
however | managed to escape having to 
take a heads-on approach to the problem 


receive a zipped copy of QPC2’s latest version 
and the zip file is password protected. Unless 
Marcel or Jochen Merz have supplied you with a 
password you will not be able to unzip the file 
and use it. This is a good compromise between 
software protection and ease of access - you 
can get the latest version immediately without 
having to wait to post a disk to Germany for 
updating, yet it allows the publisher and author 
some control over who is able to access the 
latest versions. 


2. Implementation 
After some searching | settled for two styles of 
IDE and three programs: Dev-C++ [1], RSXNT 
and SourceEdit [2]. While SourceEdit is not an IDE 
but rather an Editor, it is extensible enough to 
provide limited IDE-like functionality for small 
projects and also had already the S*Basic code 
syntax built in due to the work of Jimmy Monte- 
sinos and myself (see other article elsewhere in 
QLT). This article however focuses on the use of 
Dev-C++ as an IDE as it allows multiple configu- 
rations (and multiple compilers). 
The primary language that was chosen was C 
and the main compiler C68, for many reasons: 
1. Most of my projects in pipeline were C-based. 
2. Support for C68 has been steady and pro- 
gress continuous as opposed to qdos-gcc to 
due to lack of time has not been properly 
maintained (although some development has 
occured thanks to the work by Dave Walker) 
3. Re-targetting is possible with C68 without too 
much hassle which meant that the whole 
solution could be use for other projects as 


because of the small footprint of my code 
which was manageable without problems 
and with the existing tools. However 


when embarking into more ambitious 
projects (like the QL Mailer GNU Midnight 
Commander, KVM ~-a Java Virtual machine 
per J2ME- which required management of 
a substantial amount of code fragments 
split into dozens of header and source 
files) | had no other option but to try and 
find a way if not to bring a proper IDE 
natively under QDOS/Minerva/SMSQ, at 
least to adapt an existing one that was 
smart enough to allow scalability and 
expansion. 
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well and finally 


4. An PC port of C68 was already in ——— 


existence which simplified planning. 
The c68 port chosen initially was 
XTC68NT by Jonathan Hudson. 
Implementation was a matter of minutes 
and compilation took place immediately. 
As it was soon apparent however, a totally 
new version should be ported so to take 
advantage of the new advances in c68. 
XTC68NT last release was in 1996 which 
meant that a lot of changes were missing 
from its distribution. | proceeded to 
download whatever source was available 
for c68 in order to port/compile under 
Windows the new source changes. To 
that effect | used MingW (a Win32 gcc 
port) that comes with the full distribution 
of Dev-C++ and with some simple 


exceptions | had a more updated ~and siil 
working if you can believe that!- c68 cross com- 
pile. As | found out however while writing this 
article Dave had been hard at work updating libc 
and other components of the c68 system and as 
a result a new major recompilation will be in order 
soon. | hope that in the course of the next month 
a new site will be set up [3] to deal with the 
Win32 distribution in order to provide easier 
access to developers for the new tools. In the 
meantime however anyone can build a Dev-C++ 
based XTC68NT system that can help in the 
development of QDOS applications, Instructions 
on how to do so are in the next section 


3. Installation of XTC68NT for use 


with Dev-C++ 

Assuming that you are going to use XTC68NT/ 

c68 in conjuction with Dev-C++'s own MingW 

compilers the installation is as follows: 

a. Download and install the latest version of 
Dev-C++ from Bloodshed Software's website. 


b. Download XTC68NTzip from any of the good 
sources for QDOS software [ie sinclair-ql.it 
emulunl, or one of the PD libraries ie DJPD) 

c. Follow the instructions on creating the ap- 
| propriate directories for XTC68NT. 
Libraries have to go to c:\qllib, includes to 
| cAqlinc and a good place to put XTC68NT 


| iS under c\XTC68. Then copy the gnu 
make binary from the main_ binary 
directory of Dev-C++ to the XTC68NT 
| directory as well. (Not entirely necessary 
_| but saves time and sometimes confusion) 
1. Windows XP/2000 and NT users should 
_ update their environment variables sets to 
include a C68PATH (which should be set 
to c\XTC68 or wherever else you place 
__ the XTC68NT binaries. (This is done by 
_ accessing the System configuration panel). 
Windows 95/98/SE should add a SET 
| C68PATH = cAXTC68 entry in their 
| config.sys files while Windows ME users 
can do the same via the appropriate 
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= configuration tool although entry in the 
config.sys file will migrate these settings in 
their right place after the first reboot. 
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e. Fire up Dev-C++ 


and immediately 
go to Tools — 
Compiler  Op- 
tions. Press the 


+ icon on the 
Compiler — Tab 
and enter C68 
or something si- 
milar Then ac- 
cess the Direc- 
tories tab and 
after removing 
the gcc directo- 
ries binaries lo- 
cations, replace 
them with 
c\XTC68 {one 
other reason for 
moving make to 
the XTC68NT 


i 

i 

2 

| 

i 

| 

i 

i 

iy 
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i | 
i 
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directory!). Do —— 


“4825 Lines infile 


the same for C 
includes and Libraries replacing the entries 
with c:Aqlinc and c:\dllib respectively, C++ 
includes could be left alone although | make it 
a practice to remove them to avoid any 
confusion. Finally go to the Programs tab and 
replace the listed binaries names with the 
appropriate XTC68NT ones. 


f, You're done! 


You are now ready to start using XTC68NT and 
happy programming! 


Helpline 


Dilwyn Jones 


Question: | would like to use an lomega Zip drive 
with my Qubide system, but it doesn't seem to 
work. | have read somewhere that | should be 
able to use this combination. 


Answer: If you are using a version of Qubide 
prior to v2.00 (version number shown at the top 
of the screen as the QL starts up) you will need 
to upgrade the Qubide. The version 2 ROM 
upgrade consists of a new EPROM, new GALI 
and GAL2 chips, new Qubide utilities disk and 
instruction leaflet. These were originally available 
from Ron Dunnett at Qubbesoft P/D, but since 
Qubbesoft is not actively trading in QL products 
any more, | am not sure if this upgrade is 
available or not. 
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[1] Bloodshed Software's web page: 
http://www.bloodshed.net/ (Dev-C++) 

[2] SourceEdit Webpage: 
http://www.sourceedit.com/ 

[3] c68-Win32 Webpage: 
http://www.dokos-gr.net/c68/ 


Question: I'd like to add a mouse to my QL. How 
do | go about this? 


Answer: There are two main types of mouse 
systems for the QL. The first is based around the 
QIMI (QL Internal Mouse Interface) system. The 
QIMI is available from Quanta. Apart from the 
pointer environment itself, this needs no extra 
software. The QIMI uses a 2-button Atari style 
mouse. The second system is based on a PC 
serial mouse. This needs an adaptor lead to 
connect it to a QL serial port, and software to 
convert the mouse movement signals to QL 
pointer environment signals. One version of this 
software is the Sermouse system from Albin 
Hessler, another is a piece of softyware called 
the DIY Mouse driver from Simon Goodwin, part 
of his DIY Toolkit seriews from QL World 
magazine and available from sources of his DIY 
Toolkit series. 
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Choosing a GD2 Colour 


George Gwilt 


Before the introduction of the 
high colour modes to the QL 
scene programmers had only 
four for eight in mode 8) 
colours to choose from. By 
using stipple to combine two 
colours the number of choices 
was raised to 256. However, 
most of these do not combine 
to give readable screens if text 
is to be displayed. Hence the 
choice of paper and ink colour 
in a mode 4 program was pret- 
ty limited. 


Now that 65,536 colours are 
available, and given that these 
can be combined in pairs using 
stiople, the choice has been 
dramatically increased. Of 
course this probably means in 
practice that the programmer 
just relies on using the old and 
tried red, green, white and 
black with an occasional daring 
leap to blue or magenta. 


Unfortunately the choice of pa- 
per and ink colours for win- 
dows definitions in PE has not 
been increased, or, if it has by 
the time you read this, it is only 
very recently. TuboPTR and 
CPTR provide two ways of 
writing PE programs. Up to 
now the programs setf and 
setz, which enable the easy 
production of window defini 
tions, only allow the user to 
specify the usual mode 4 
colours. 


| have been developing a way 
of letting a user pick one of the 
enhanced colours. When | 
know exactly how the new 
WMAN uses the new colours | 
will incorporate this in Turbo- 
PTR and CPTR. 


For the moment | will simply 
offer a few notions on how a 
colour might most easily and 
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usefully be chosen by a user of 
sett/setz. 


Palette 

Given the 65,536 colour values, 
it is not immediately obvious 
how to pick, say, red by value. 
In fact for a long time now 
TurboPTR has included the 
values for a mode 33 red, 
green, blue, yellow, white, cyan 
and magenta so _ using 
COLOUR_NATIVE on a Q40 or 
Q60 presents no such problem. 
But what of the other possibili- 
ties? 

One way in which the problem 
has been tackled is by the use 
of COLOUR_PAL. In this mode 
a defined subset of 256 colours 
is available. The first 64 of 
these have been given names 
in the standard palette supplied. 
TurboPTR uses these to allow 
sprites to be defined using one 
character for each of the first 
64 palette colours. 


Currently setf/setz can display 
256 basic QL colours (using 
stiople), so to display 256 
palette colours would be quite 
feasible. 


This is one of the ways in 
which | would propose to en- 
hance settf/setz. 


Full Range 

It would seem too restrictive to 
allow only a palette approach 
to deciding colours. However, 
to allow the display of all 
65,536 colours would be 
wasteful of time and would pro- 
bably make the choice too 
cumbersome. 


The way | suggest is based on 
recognising that a particular 


colour can have 31 different 
shades (excluding black). Each 
colour is defined by the ratio of 
red to blue to green. The 
brightest shade is that when 
the most predominant colour 
has full intensity. By reducing 
the main colour through the 31 
steps towards black and by 
reducing the intensities of the 
other two colours in proportion 
we wil get the different shades 
of the colour There are thus 
around 3,000 different colours 
on this definition. This is much 
more manageable than 65,536. 


First of all a main constituent 
colour is selected. Then the 
proportions of the other co- 
lours are chosen by up or 
down arrow keys. As the keys 
move so does the selected 
colour change in a display win- 
dow. When the colour is satis- 
factory it can be chosen by 
pressing ENTER. The next 
stage is to select the shade, 
again by arrow keys. Again the 
displayed colour changes to 
show what is currently selec- 
ted. 


Finally, if a stipple is wanted a 
second colour can be chosen 
and, when that has been set 
the stipple value can be 
selected. 


A selected colour will consist 
of various proportions of red, 
green and blue. This in turn will 
give rise to the value of the 
mode 33 word. This makes it 
possible to pick exactly the 
same colour in future by value 
alone, which is_ the _ third 
method, complementing the 
second one. 


Selection by Value 

The option to pick a colour by 
value alone can speed up the 
process if a colour has been 
selected previously and its 
value is known. 
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Launchpad Preview 


John Perry 


| never used to like Graphical User Interfaces. 
They never seemed to manage to do any of the 
clever things you could do from a command line. 
For all its painfulness, DOS had its attractions 
over early versions of Windows. 

Similarly, | was always grateful that QDOS and 
SMSQ/E were basically command line driven, 
with the options of utilities like QPAC2 and 
various file handlers to make life easier. 

In terms of program execution utilities, programs 
like Taskmaster and DEV Manager had their 
attractions in terms of making life easier but 
always seemed to be one step behind what | 
wanted them to do. 

In recent years, although | always preferred the 
QL, | became increasingly aware of Windows, 
after all, it's hard to avoid M$ systems in the 
great big wide world of business out there. While 
| hated Windows ability to drive me totally insane 
at times, there was a grudging feeling that 
putting the pretty front end onto operating 
systems was what people wanted, and if a 
computer looked good it could to some extent 
fool you it was a good computer And having 
programs which all looked the same and 
operated in a similar way was quite an attractive 
idea. 

Programs like Cueshell, QRAM and QPAC2 for 
the QL have given a degree of taste of what 
such a system for the QL might be like, and on 
the whole | quite liked those systems. Having 
seen the articles about QDT and little snippets of 
information about Launchpad helped make me 
wonder what a full GUI for a QL might be like, 
especially now that SMSQ/E and the various 
emulators are almost daily enhancing the capa- 
bilities of QL systems with more colours, higher 
resolution and all sorts of other enhancements. 
While SBASIC has new commands for all these 
new facilities, it's becoming increasingly hard to 
remember all of them and now that the basic 
Capabilities are there, we may as well make the 
effort to ‘pretty up’ the QL interface now that so 
many people are using pointer environment and 
mice on QL systems. 

Having been a bit of a fan of Dilwyn’s QL pro- 
grams over the years, | was looking forward to 
the release of Launchpad and begged, pleaded 
and virtually bullied him to be given the first copy 
of the program. In the event, what | got was not a 
full version of the program, but what turned out 
to be the first working version, minus documen- 
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tation and some accessory programs, and a 
warning that it was the first alpha-test release, full 
of bugs. 

| got about one page of notes and little else with 
which to get it going, but it turned out to be not 
only possible but quite a surprisingly painless 
experience given the early status of the program. 
The down side of all this was that within days of 
getting the program, it was a condition of receiv- 
ing it that | write a review for QL Today. Given the 
unfinished nature of the program and the rather 
short notice in which this review was produced it 
might be better to look on it as a preview rather 
than a review as such, and | hope that any mis- 
takes | make arising from the very short period | 
had in which to write this will be corrected by the 
time you read this. I've also been unable to pro- 
duce screen dumps as the Screen Grabber part 
was incomplete in the copy | got, so I'll have to 
ask QL Today to add screen dumps where possi- 
ble. 

[| have added screen dumps from my system, 
but in fact you did not have to use the Launch- 
pad screen grabber utility, any screen capture 
utility would have done the same job - Dilwyn] 
Launchpad is what is called a Graphical User 
Interface. Rather than typing in commands you 
select them either from menus or by clicking on 
little symbols or icons on screen. While Launch- 
pad is primarily described as a ‘Program Laun- 
cher’ (you create a list of programs the program 
will start automatically for you) it actually does a 
lot more than that, not that you'd guess from the 
rather spartan or minimal initial appearance - just 
a few symbols across the top, a few commands, 


Fig.1 - the basic program layout 


What you get is basically one large program 
(LAUNCHPAD_OBJ) which is the main program, a 
couple of small system files called 
LAUNCHPAD_DAT and LAUNCHPAD_PWL (which 
allegedly contain the settings, program icons, 
passwords and so on), plus a few smaller ancilla- 
ry programs such as a couple of games, a gra- 
phics viewer a text file viewer a calculator 
(missing in the version | got), a file handling 
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program called Q-Tfans which you may already 
have heard about and a few other programs 
which collectively go under the title of an 
Accessories menu. Some of these programs are 
missing (probably incomplete) as yet, some are 
fairly trivial and others rather good. Installation 
takes a little time - you have to copy the program 
onto your hard disk or a system floppy disk and 
configure Launchpad. There is no automatic in- 
Stallation, but the process is easy enough as long 
as you have used Config or MenuConfig (the 
Standard pointer environment configuration pro- 
grams) before, although the size of the files 
means it takes some time to copy everything. 
But back to the basics. The program works on 
the basis of a desktop which contains all of the 
commands and icons. In fact, there are four 
desktops (which the author refers to as Menu 1, 
Menu 2, Menu 3 and Menu 4). If you are familar 
with a Windows desktop, that is perhaps the best 
comparison. Indeed, if you are familiar with 
Windows, you will probably find it easier to use 
Launchpad as many of the principles will be 
familiar to you. 

Go to the File menu at the top left and click on 
the Add New Program entry in the menu that 
appears. Unless all of the icons in the current 
desktop are already used, the first available is 
selected and an Item Definition Form appears. 
This is truly frightening at first, as it contains 
nearly 30 possible entries for each program you 
add to Launchpad! 


Fig. 2 Item Definition Form 


All is not lost. It turns out that for virtually all 
programs, only 3 or 4 items need be entered - 
the filename of the program to execute, a name 
for it on the desktop, an icon to use and possibly 
a ‘job’ name, which is the name you see when 
you type a JOBS command in basic, this allows 
Launchpad to pick a program for you. 

For awkward programs, you can set anything 
from DEV devices to memory _ settings, 
DATA_USE, PROG_USE and all sorts of other 
settings. See figure 2 for the myriad settings 
possible. This frightened me at first and nearly 
put me off, but once | realised that only the top 4 
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are needed for most of the programs | use, | 
breathed a sigh of relief. It was a bit like learning 
to ride my first bike. When | first got on the bike 
and promptly fell off, it nearly put me off trying to 
learn, but a bit of perseverance soon paid divi- 
dends and | quickly got several programs set up. 
When you set up a program, the settings are 
added to a system file in Launchpad’s program 
directory. Depending on the speed of your 
system, this may not be noticeable. Given that it 
was an early program which | was a bit scared of 
given the warning about bugs, | ran it from a Zip 
disk to start with until | gained in confidence, 
because | was rather afraid of what it might do to 
my hard disk. The delay in writing to the system 
files was noticeable as a momentary freeze of 
the display (less than a second, but noticeable). 
Once | gained the confidence to move it all to my 
hard disk system, the delays were barely notice- 
able at all and had | not been warned that there 
was some hard disk writing in operation | might 
not have noticed it on the hard disk system at all. 
Once you have a few icons set up, it’s time to 
learn the very complex procedure to execute 
the program. Just click on either the icon or the 
name underneath it. Yes, just one click and off 
the program goes! After the Item Definition Form 
this was a nice surprise even if my early multi 
clicks on some icons did manage to launch seve- 
ral copies of some programs. 

Actually, if you HIT (left mouse button click or 
press SPACE with the pointer over the program 
icon), it tries to launch (or execute) the program. If 
you DO (right mouse button click or press 
ENTER while the pointer is over the program 
icon you get what the author calls a ‘context 
menu’ - a menu Called ‘Action’ appears with all 
sorts of options on it to do with that particular 
program (see figure 3) 
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Fig. 3 - Action or Context menu 


About a dozen options become available. You 
can start (or ‘launch’ a program - just to prove it’s 
an early version, the program uses the term ' 
Exec’ in some places, ‘Launch’ in others and even 
‘Open’ in one place). You can pick a program, you 
can alter its settings, you can sort the menu, you 
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can even copy an icon if you need a similar entry 
for another program (e.g. having set up Quill, you 
might wish to copy it to setup Xchange with the 
same icon}. Moving an icon is an experience and 
a half - click on Move, suddenly the icon starts 
floating, you can move it all over the display in 
drag and drop style. You can even click on the 
Menu Number icons top right to drop it into 
another menu. I've never really seen this on a QL 
program and it was a bit of a scary experience 
at first as | had no documentation on it. In fact it 
proved quite useful - the program usually puts 
new icons in the first available slot working from 
the top left corner of the desktop, so this was 
useful for putting the icon where you prefer it. 

In fact, | later found that if | selected NEW from 
the action menu of an unused icon location, | 
could set up the icon where | wanted it without 
having to MOVE it. If anything, this was easier 
than the Add New Program command from the 
File menu. 

This showed up a feature | wasnt too sure 
about. Icons have to be placed on a regular grid. 
Imagine some ruled graph paper, all icons have to 
be in a line vertically and horizontally, you can't 
have one halfway down another one in the same 
way as you would with the Windows desktop. 
And you can only have a maximum of 40 icons 
per desktop in an 8x5 grid irrespective of screen 
resolution. The gap between them just gets big- 
ger on higher resolution screens, but the scaling 
does change automatically, so if you set them up 
on a QL sized screen then later changed to an 
SVGA screen, the icons don't end up clustered in 
the original QL-sized area in the top left of the 
screen or whatever. This is a bit of a ‘swings and 
roundabouts’ situation, you tend to want pixel 
fine positioning, but set up several icons and 
think about it and you'd end up with a complete 
mess, possibly with icons hidden behind each 
other which has happened to me with Windows. 
Launchpad seems to handle all this automatically, 
I've never ended up with hidden or overlapping 
icons so far Another limitation is the fact that 40 
icons per desktop and 4 desktops means that 
the maximum number of programs you could set 
up seems to be 160. There seems to be no equi- 
valent to the Windows START menu for setting 
up programs in a menu without icons, unless this 
is something which doesn't yet exist in this early 
version. 

[This is not something | had planned on adding 
to the program, but if users find “only” 160 icons 
too restrictive, | may consider adding such a 
facility, although you could always use the 
Jonathan Hudson Qascade program - Dilwyn] 
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lf you don't use a program often enough to 
warrant assigning it an icon of its own, there is a 
command called Launch A Program in the Launch 
menu, which brings up a file selection menu 
somewhat akin to the Q-Trans file lists. In this list, 
filenames are preceded by an E if the file is an 
executable program - click on one of these file- 
names and another window opens which lets 
you either start the program as its is, enter a 
command string or even specify some memory 
to protect for Psion programs (Quill etc), guardian 
windows, unlock, freeze or impure - | think these 
are essentially like those available for the EXEP 
command in basic. 

in fact, it seems possible to execute files other 
than the normal executable programs. It seems 
to work via File Info, but as | do not have any 
instructions for Launchpad at the moment, it's 
difficult to know exactly what is possible here, 
except to say that this could well be very useful - 
you could start a text file, and your text editor 
pops up to let you view and edit it, for example. 
Also on the Launch menu is a sub-menu called 
Accessories. As the name implies, this contains a 
number of smaller programs like a file handler, 
calculator, a couple of games, a screen grabber a 
screen saver program and so on - see figure 4 
for details. The games are fairly trivial and unexci- 
ting, though serve to pass the time. The Q- Trans 
file handler you may already know about be- 
cause it was released by itself and has been de- 
scribed in QL Today. The character map program 
is useful, it shows the complete QL character set 
and you can click on a character and send it to 
the hotkeys stuffer buffer to transfer to another 
program, really useful if you use accented or 
special characters and don't know where they 
are on the keyboard and dont have the manual 
to hand. | can't comment on some programs 
because they were missing, probably not 
complete yet. Fortunately, Launchpad seems to 
do no more than complain it can't find them then 
carries on without them. 
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Figure 4 - Accessories menu 


The Launch menu also includes a PICK menu. 
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The names of the icons on the desktop appear 
here and you can click on one of these. If the 
program is already running, its display pops up 
ready for use. If you are only using one or two 
programs at a time, it's easier to use CTRL C to 
get from program to program than to wade 
through this menu to find the program you want, 
although if you have several programs on the go 
at once, it might be easier to use this menu. 

The final item on this menu is something which 
seems to be available only to QPC emulator 
users. It Seems to be possible for Launchpad to 
launch a DOS or Windows program from within 
QDOS or SMSQ/E on a Windows machine. | was 
unable to test this. 

[This facility is simply like the QPC_EXEC 
command in QPC2, this is not really a 
Launchpad facility, it simply uses an underlying 
QPC2 facility - Dilwyn] 
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Figure 5 - QPC:Launch DOS/Windows file 


Launchpad itself seems to sit quietly in the back- 
ground until needed. In fact, it seems to be just 
another program which you can CTRL C in and 
out of, pick with a hotkey and so on. Normally it 
occupies the full screen, so if other programs 
overlap, you can also pick it simply by clicking on 
any part of its display. In this respect | think it's 
probably wrong to call it a GUI or front end on 
the operating system because it doesn't really 
change the behaviour of the QL at all in the 
sense that such a front end might be expected 
to make. On the other hand, | find it good that as 
far as | can tell, you continue to use the QL as 
normal and there is less risk of creating incom- 
patibilities and changes to the way things work. 


Users 

This was an area of the program that | had great 
difficulty understanding, until | realised it works a 
bit like the corresponding facility in Windows. | 
had very little by way of instructions, so I'll cross 
my fingers and hope the following description is 
correct. 

lf several family members wish to use the QL, it 
can be handy to have separate setups for all of 
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them. My youngest likes to play games, my 
eldest doesn't really use the QL and my wife 
only really uses it to play the occasional game 
and type a few letters and maintain some lists for 
an organisation she’s a member of. I'm the main 
user. 

When you first use Launchpad, it's set up for just 
the one user and there are no passwords or 
anything to worry about. You start the program, 
the desktop and your icons all appear and that's 
all there is to it. 

lf you wish to make it have a different set of 
settings for anyone else using it, you have to use 
the Users command in the file menu. With this, 
you can add a list of users (I think the limit is 16 
users). Users can have names to identify them 
and if required, a password. If you leave the pass- 
word blank, it means no password. 
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Figure 6 - Users menu 


There always has to be at least one user, it 
doesn't seem possible to delete the first one. If 
the settings for a new user are similar to an 
existing one, you can even copy the settings for 
that user into a new user and take things from 
there. 

Once you have set up a few users, the next time 
you start the program a Login screen appears, 
where you have to enter the name of the user, 
plus the password if one was specified. Unless 
you get this right, the program won't let you in, 
which might be a bit of a problem if ever you 
forgot the passwords. | asked Dilwyn about this 
and he did say that finished versions of the 
program will come with a small program to edit 
and reset passwords to cover this eventuality, 
though he did admit that there was no way of 
recovering forgotten passwords from within 
Launchpad itself (security reasons maybe, 
though | don't really see the QL as being ‘secure’ 
in that sense since you could simply CTRL C to 
BASIC and exec a program from there, Launch- 
pad does nothing to prevent that). 

[You could simply EXEC_W Launchpad if all 
you want to do is restrict access to BASIC - 
Dilwyn] 
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Figure 7 - Login screen 


The File menu has a Logoff option in addition to 
the Exit command. Logoff simply clears the 
display and takes you back to the Login screen 
ready for another user to use the program - 
useful in an office environment | suppose. 


My@QL 

The next step for me was to explore the MyQL 
menu, which contains a real plethora of facilities. 
The name MyQL is in fact remarkably apt, since 
it's mostly about specifying system settings such 
as display resolution, mouse speed and so on. 
I'm not sure | fully understand all of it and it will 
certainly take time for me to get used to it all. 
The main thrust of it seems to be that the top 8 
icons are for setting the clock, display, keyboard, 
Launchpad’s own settings, mouse, network, 
system settings (DATALUSE, PROG_USE, DEV 
settings, various _-USE commands and a facility 
to create new directories) and a Users icon whcih 
seems to be the same as the one in the File 


menu. 
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Figure 8 - The MyQL menu 


The bottom eight icons seem to launch the 
Q-Trans file handler to list files on the device 
shown. In my case only 4 of the possible 8 items 
were shown, presumably it only shows icons for 
devices which actually existed - in my case, 
FLP1_, DEVi_, WINI_ and RAML_ (although | have 
two floppy disk drives and there could be up to 8 
ramdisks, it only showed FLP1_ and RAML_, | 
don't know if this is a bug or how it is intended to 
work). 
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[That's how it's meant to work, if you want the 
other drive (s) just press the number in Q-Trans 
when it starts, so to get FLP2_ click on the 
FLPi_ symbol then once Q-Trans is up and 
running, press ‘2’ in that program - Dilwyn] 


Figure 9 - The Q-Trans file handler 
The menus themselves are quite easy to use. 
Take the Clock Set one for example. A box 
appears, in which a clock shows the current time 
at the top and you can then click in one of the 
six small boxes to set anything from the seconds 
to the year number. Think ahead slightly and set 
it a few seconds beyond when you enter the 
seconds, as the time is not changed until you hit 
the OK button at the bottom. If you make a 
mistake, this gives you a chance to correct it first, 
or you can hit the ESC button to abort setting 
the clock. 


The Display part lets you set the preferred 
screen resolution, the colour depth on modern 
systems like Q40 which offer more than one level 
of colours, the screen saver type and delay 
before it cuts in (this is quite a good screen saver 
program which works with mouse or keyboard, a 
choice of screen saver types and you can even 
write your own screen saver module, though no 
information was provided on how to do this), plus 
background colour and image (presumably like 
Wallpaper etc in Windows, though | didn't have 
the time or information on how to use this before 
writing this). 
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Figure 10 - The Display settings menu 
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The Keyboard menu lets you set the usual auto 
repeat delay and frequency settings, though 
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most people won't need to bother. It will even let 
you change CTRL C to some other keys if you 
wish, though why anyone would want to do this 
is beyond me. You can also set an SMSQ/E 
keyboard language table from here. Again, | didn't 
know how to approach using this. 


The Launchpad settings window just lets you 
specify where Launchpad finds its system files, 
and what printer port it uses when it's printing. 


The Mouse part lets you set the mouse 
acceleration and wake up speeds. Most people 
won't need to bother with this. 


The interesting part of this (translate that as “hard 
to grasp at first’) is that it not only sets some- 
thing there and then, but next time Launchpad 
Starts it tries to use these settings, so you have 
to be a bit careful. In fact, it seems to go a step 
further, all users seem to be able to have their 
own settings, so if | prefer a great big 800x600 
display and my games playing son prefers to use 
512x256 QL displays for all the old games which 
won't run on bigger displays, that's perfectly 
possible. | assume though that some care is 
needed in case this screws things up as | don't 
know things would work if you set some impos- 
sible settings, though | suppose QLers know their 
own machines and what should be possible. 


Launchpad has a Help menu, but no help text 
was available, only the ‘Copyright’ screen was 
shown. Apparently it will show a Help file in 
finished versions. 


Summary 

| was initially wary of using Launchpad, as it was 
incomplete and described as being ‘full of bugs” 
and a bit unstable. It proved to be a little bit 
better than the warnings implied, indeed as long 
as | am careful to avoid the areas of problems | 
know about, it is remarkably stable given that it is 
the very first version released to a few testers. It 
is very like Windows in some respects, but 
always with a QL feel to it (Windows with a QL 
feel? What a horrible thought!) so QLers used to 
Windows will probably find it easier to master 
than those who have never used any sort of GUI 
before. Unfortunately, the Windows feel even 
extends to General Protection Fault, although its 
use is different in Launchpad. If Launchpad 
crashes it comes up with a General Protection 
Fault screen and a short description of what went 
wrong (I first copped it when entering passwords, 
there is definitely a problem there as it seems 
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unable to accept some names as passwords in 
this early version). | never thought I'd live to see 
the day we got General Protection Faults on the 
QL unless it’s the author's idea of a sick joke! 


| am happily able to use this early version with a 
bit of care as | get used to the bugs in it and 
avoid them. It happily sets up, launches and picks 
programs (one bug is that you can pick 
SuperBASIC from the Pick menu but not by right 
clicking and selecting Pick from the Action 
menu). If seems to happily change system set- 
tings and do most of its operations, the Accesso- 
ries menu will prove quite useful when complete 
and all in all its a pretty nicely thought out 
system, though | would like to see a Qascade- 
style text menu built in as it can be a bit awkward 
finding icons when you have loads of them set 
up on the desktop. 

The multiple users facility is probably overkill for 
many people and most will avoid setting up 
passwords and so on. The facility, like many in 
Launchpad, is there for those that need to use it 
and hidden away when not used. | like the way 
the login screen never appears if there is only 
the one user with no password, and the whole 
login procedure itself is simple enough, although 
the procedure for setting up new users is difficult 
without instructions. 

| also like how the most commonly used features 
are those easiest to access and the least used 
features are hidden so that they don't get in the 
way. Launching a program from an icon is simplici- 
ty itself - just left click on its icon and off it goes. 
The menus are clear and simple on the whole, 
the icons are pretty basic by modern standards 
but not bad by the standards of some QL screen 
graphics I've seen - it can't be easy to do some- 
thing like this with basic 4 colour 512x256 pixel 
Screens. 

The colour scheme is very limited, basically 
white and that's it. Initially | thought that given the 
relationship of black and the QL, it might have 
been better to reverse the colour scheme and 
make Launchpad black like the QL, then it 
occurred to me that the white Launchpad 
backing stands out against the black backing of 
most programs like Quill. 

Using Launchpad from floppy disk is a bit of a 
pain. You have to configure it to prompt for the 
System Disk when you change something, 
because it needs to save the new settings, 
although | think that pressing ESC will allow you 
to continue without saving the changes, and the 
program forgets the changed settings next time 
it starts. 
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One thing | did notice was that when you quit 
from Launchpad, it does not shut down any jobs 
it started which are still running (screen saver 
excepted, | noticed). | don't know if this is a bug, 
or an intentional feature. 

[The latter - | thought it too restrictive and risky 
to close everything down, | noticed | kept for- 
getting to save files before quitting Launchpad 
and lost quite a few unsaved files while 
developing Launchpad, so | thought I'd save 
others from suffering this problem - Dilwyn] 


| find Launchpad very promising as long as you 
can live with some shortcomings like lack of 
choice of colour schemes (the program is written 
with Easyptr so this may be a reason) and a lack 
of an equivalent for a Windows Start button - I'd 
like to see this added to the Launch menu as an 
extra command, something like Launch Menu. 


The icon names possible are quite short even 
when large display sizes are used - a maximum 
of 9 letters in the preview version. Icons have to 
be on a regular grid and can't be positioned with 
pixel-fine accuracy, though this does have the 
benefit of meaning you don't suffer from hidden 
or overlapping icons. You have to use the built in 
icons, it doesn’t seem to be possible to load any 
additional sprites or anything else you could use 
as icons, and there is no control over the fixed 
icon size. That said, there is a good choice of 
icons built in (two pages of icons available to 
choose from when you add a new program 
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symbol). Launchpad makes quite a demand of 
your system, the program itself is some 
300kilobytes in length, very large for a QL 
program and seems to demand quite a lot of free 
memory. 


Overall, | am very pleased with this program, and 
despite the warnings issued with It regarding the 
early version bugs, I'm happily using it regularly 
on my system after only a few days of receiving 
it without too many problems. It really makes a 
difference to how | use my QL! | am really looking 
forward to the completed version! I've seen 
Launchpad described as a ‘less ambitious’ 
system compared to QDT If true, I'd really like to 
see QDT! 

| notice that the author has set up a Launchpad 
page on his website - see 
www.homepages.tesco.net/dilwyn.jones/launchpad/ 
launchpad.html 

for more information on this promising little utility! 


Editor's note: | do not normally add as many 
comments of my own to such a review, but 
given that | am the author of this program and | 
asked John to preview an unfinished product at 
such short notice without instructions, | felt 
obliged to make the highlighted additions to the 
review to correct some errors (indeed as 
requested by the author of this review). | also 
added the screen dumps which show the 
program running in more ideal conditions on my 
system. Dilwyn Jones 
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Compiling the SMSQ/E sources 


with GWASS 


Wolfgang Lenerz 


George Gwilt makes a compel- 
ling case for using his very fine 
GWASS compiler for compiling 
SMSQ/E (see last issue of QL 
Today, p.17). 

| find the idea of using an ac- 
tively supported assembler for 
the sources very appealing. 
This is even more so as | don't 
know at all what the current 
status (if there is any) of deve- 
looment of the QMAC compiler 
is. lf my memory is Correct, it is 
sold by Quanta, but | don't 
know whether there is anybo- 
dy still supporting that program 
(on the other hand, it seems to 
have pretty little bugs). So, in 
principle, using Gwass for com- 
piling the sources is something 
that | welcome. 

Well, as they say, the devil is in 
the details. There are several 
things, that, for the time being, 
seem to preclude using Gwass 
on the SMSQ/E sources. 

The first is that the sources 
themselves must be changed, 
notably in the way Macros are 
called. George points out that 
most macros will have to be 
extensively changed. That in 
itself isn't that much of a 
problem - there are “only” 18 
macro files in the SMSQ/E 
"mac’ subdirectory, and some- 
body really determined could 
go through them pretty quickly, 
| guess (there are also macros 
in some normal source files). 
No, the problem as | see it, is 
that the macro calls them- 
selves must be changed - and 
this will be a LOT of work. Each 
and every source file will have 
to checked and, possibly, 
changed, because many of 
them use macros. 

Moreover, you know how it is - 
change something in a source 
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file, and it, or something else, 
will break, even if it's only a 
macro call. So an extensive 
round of testing would have to 
follow - even more work. Yet, 
this could be overcome with 
enough work. /m just not sure 
that the work should be poured 
into these changes, rather than 
developing new things for the 
system. But hey, it's a free 
country, and if people want to 
work on that, I'd take anything 
that | could get... 

However, once the sources are 
changed, QMAC will no longer 
compile them, and that, as we 
Shall see now, is more of a pro- 
blem. 


Indeed, the second reason 
stopping me from adopting 
GWASS for the sources is, to 
my mind, more serious: GWASS 
doesn't work on all machines. 
This is not some kind of a bug, 
but a deliberate design deci- 
sion by George: GWASS needs 
at least a 68020 processor to 
function. However, several ma- 
chines on which SMSQ/E can 
run, do not have a 68020. 
These are the Atari ST ma- 
chines, the GoldCard machines 
and, most importantly, QPC. 
Now, I've always stated that | 
wanted SMSQ/E to be cohe- 
rent, as much as possible, on all 
machines across the range. 
This also implies that you can 
use all of these machines to 
(re-;compile the sources. Using 
GWASS would simply exclude 
the above mentioned machines 
from that. | cannot, at this stage, 
condone something like that. 
Of course, it is probable that 
some of the machines that'd be 
left out in the cold would not 
need the facilities offered by 


GWASS, but, if QMAC can then 
no longer be used to compile 
the entire sources, this wouldn't 
further us in any way. 

And, finally, a pretty much sel- 
fish reason to exclude GWASS. 
The whole purpose of using 
GWASS is to introduce into the 
sources advanced instructions 
that can be used by the more 
powerful processors found, €.g. 
in the QxO or Atari TT ma- 
chines, with the aim of making 
the OS ever more faster and 
efficient - which, of course, is 
something we can all agree on 
(| think!). However, for the time 
being, this puts debugging at a 
severe disadvantage. Indeed, |, 
like most others, use the 
QMON/MON combination to 
debug the OS. Unfortunately, 
QMON/MON can't _ handle 
these advanced _ instructions. 
So they will generate an error 
each time they encounter 
these instructions, which can 
(and probably will) make de- 
bugging the OS a nightmare. 
Now, it so happens that | seem 
to be the person at whom ma- 
ny ‘problems’ with SMSQ/E 
seem to be directed. | don't 
really know why this should be, 
since that isn't part of the job 
description of the registrar - but 
it is a fact that this happens. So 
| do quite some debugging. 
And | can't see myself doing 
that without a tool that can 
handle the instructions and 
allow me to step through them. 
There are already some very 
few 68020+ instrcutions in the 
code (for the Qx0 machines} 
and using them is not easy. 
The solution, of course, would 
be to amend QMONJMON, but 
| don't think that this will happen 
anytime soon, probably for 
copyright reasons. 

So that leaves me out in the 
rain - which is why, for the time 
being, | can't see myself using 
GWASS for the sources - unfor- 
tunately! 
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SourceEdit - A new 
SuperBasic develop- 
ment tool 


Phoebus Dokos 


About A few days ago, Jimmy Montesinos, asked 
me if | have a syntax highlighter for SuperBasic. 
Truth be told, | was trying for a long time to finish 
a project using the Unired editor However the 
coloriser script used by UniRed albeit powerful, 
was very difficult to use and required a lot of time. 
| was all but resigned to the idea (although the 
work had progressed to about 70%), when Jimmy 
showed me a couple of screenshots of his work 
with SourceEdit. | was intrigued and promptly 
downloaded SourceEdit (which is free). Source- 
Edit, apart from its syntax highlighting feature, 
also sports an Intellisense-like feature that com- 
pletes your code (by pressing Ctrl-Space provi- 
ded definitions for the keywords exist), an ability 
to use custom help files (a couple of words on 
this in a bit), plus user-defined tools. 

Its language editor was extremely easy to use 
and although not as powerful as the features of 
UniRed, | decided I'd give it a try. Within minutes | 
had my first quasi-working script (basic stuff 
REMark, FOR END FOR loops and the like) and | 
was very impressed. Accordingly | went on to 
compile a basic list of keywords. In the meantime 
Jimmy sent me his work thus far and | started to 
enhance that. Jimmy had included all the opera- 
tors and most of the Loop constructs but lacked 
extra keywords. Thanks to the EXTRAS facility of 
TK2 (and SMSQ/E) | was able to send such a list 
to a file, promptly processed it with SourceEdit to 
make it to a PC-style text file (CR/LF - By the 
way SourceEdit supports QL-style files ie LF 
only), merged it with the list of keywords by 
Jimmy and after importing them into OpenOffice’s 
Calc | removed all double references, added extra 
keywords that didn't make it into the list (EXTRAS 
doesn't list everything, for example AT and 
RE Turn are ommited). 

We weren't totally satisfied with the results as it 
would mean that a significant amount of QL pro- 
grammers wouldn't have all the keywords that 
they usually have in their programs. Although ex- 
tremely easy to use we didn't see a point of 
having everyone do their own changes as 
SourceEdit and the SuperBasic language defini- 
tion wouldn't be much of helo (would it really? 


:-) }. 
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Jimmy and |, started gathering the major toolkits 
(Turbo Toolkit and the Q_Liberator extensions), 
the FPU FN extensions, the RomDISQ and Super- 
Hermes drivers/extensions, the cache mode ex- 
tensions and a couple others we got our hands 
on and compiled a rather large recognised key- 
word list of (currently) 578 entries. 

The result was recorded into a SourceEdit lan- 
guage file (which in the SourceEdit's author's 
honour, was put online minutes after being sub- 
mitted by Jimmy!) 


Why? 

The answer is why not? The reasoning behind 
the use of Windows is not because | prefer Win- 
dows over SMSQ/E (The contrary happens actu- 
ally!) but the fact is that we lack development 
tools under SMSQ/E. The only program that we 
have for really powerful editing on the QL is QD 
but for production use | find it very difficult to use. 
(| have to stretch that, that's a 100% personal 
peculiarity, nothing to do with the quality or the 
features of the program which | find outstanding. 
My main problem is with the way the QL treats 
the cursor and how it’s tied to the mouse which | 
always found utterly silly :-) | do prefer 
shift-cursor or PgUp/PgDown to mark large parts 
of text and so far, no text editor (that | know of) on 
the QL supports that). Another reason has to do 
with the ease SourceEdit can be tied to an 
integrated development environment. (QD can 
too, but such an integrated development environ- 
ment doesn't exist on the QL yet). As with many 
other platforms you need tools to create tools as 
it's one of the most complex parts of the pro- 
gramming life-cycle. In short, if something similar 
was available for Linux and was as easy to use | 
would opt for that. In any case cross-platform 
development is not a big deal for me. Even 
Amiga-Dos was originally developed on the QL! 


Installation and use 

After installing SourceEdit the procedure for the 
SuperBasic language is straightforward. Decom- 
press the superbasic.zip file directly into the 
LANG directory (usually c\Program 
Files\SourceEdit\LANG) and youre in business! - 
Well not really... read on! - 

In order to use the language file and assuming 
that you are going to be using SourceEdit for QL 
work only (don't you dare of thinking about any- 
thing else!), you should access the menu Tools 
and then the menu Options (Or go directly there 
by pressing ALT-ENTER). Select then "Language/ 
Tabs’ (See fig. 1) and then click on the ‘Language’ 
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language definitions that you will see immediately 
after downloading. 


The future 

Jimmy has been working on a line number 
Stripper filter (that can be called from within 
SourceEdit, that simplifies editing) and that can 
later reintegrate numbers {not that they are 
required anyway as SBasic doesn't need them 
really and if no GOTOs or GOSUBs exist then you 
have no problems). Additional changes planned 
are a even more complete SuperBASIC keyword 
list catering for virtually all toolkits in existence 


this will make sure that your REMark ap- 
pears correctly and not as “REMARK” or 
“remark”. Selecting Default Language will 
make sure that all your new files will fol- 
low the Superbasic standard and Auto 
indentation style set to ‘Follow language 
scoping” will make sure that the contents 
of constructs (ie FOR..END FOR, DEFine 
PROCedure..END DEFine) will be indented 
for readability. Tabs should be put to your 
favourite style. The Color/Font option in 
the Options dialog, can be very helpful if 


you dislike the colouring style that 
SourceEdit's author favours, giving you 
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Fig. 2 


the ability to ase it to your liking. The last 
thing you need to change is the Files options 
after you create a filter for Sbasic files (see 
figure 2). 

SourceEdit also gives you the option of 
changing your Language definition on the fly 
by clicking on the Language toolbar's drop- 
down (see figure 3). 

While typing you'll see that you can call up 
keywords by pressing CTRL-SPACE (See 
fig.4). SourceEdit comes as well with other 
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and a Custom SuperBasic Help file -That would 
give programmers a more complete solution for 
cross-platform development-. Who knows 
maybe we could even write a cross-platform 
SuperBasic language compiler... 


Links 

Jimmy Montesinos’ site (QL2k etc): 
http://www. jadiam.org/QL/index.php 
SourceEdit site: 
http://www.sourceedit.com/ 
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We Lesser Mortals 


Geoff Wicks 


My ex-wife once bought a lap- 
top for her work. "No big deal”, 
| hear you say, but this was in 
the pre-Windows days when 
laotops were called portable 
computers and cost an even 
bigger fortune than they do to- 
day. As sold the machine was 
almost unusable because it 
was configured for Dutch use, 
but had a UK keyboard. Most 
PC experts brushed off my 
complaints with a supercilious, 
‘It's simple. Just change the 
KEYB command’. 


The experts were wrong. 
When something costs £2,000 
good customer service means 
no tweaking should be needed 
to make it work. And changing 
KEYB was far from simple, 
because some of the keys 
used to access the command 
were the ones that did not 
work correctly. It took me over 
half an hour to study the UK 
and Dutch keyboard maps, and 
then type in an odd looking 
command line to get the com- 
puter working. 


Stories like this bring out the 
smugness in QL-users as be- 
ing typical of the impersonal, 
commercialised PC world with 
its complicated operating sys- 
tem, unlike our simple, user- 
friendly QL community. 


| have news for you. When it 
comes to dealing with people 
who don't understand their QL, 
we Can be just as offhand and 
unhelpful. | know this from 
some of the telephone calls 
and emails | get from users 
with a problem. One man, 
wanting help in recovering his 
deceased father's QL files, 
wrote in frustration after a bad 
experience with a QL expert, | 
am a Windows user not a 
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Linux/QL specialist’. | comfor- 
ted him by saying our skilled 
programmers mean well, but 
some have difficulty in under- 
standing the problems ‘we les- 
ser mortals” have. 


This article was inspired by 
another recent telephone call. 
A user was unable to transfer 
his files using QL-2-PC Trans- 
fer, but from his description of 
the problem | could not under- 
stand what was going wrong. | 
asked him to phone back half 
an hour later so that | could set 
up my machine and_ follow 
what he was doing step by 
step. When he did _ this 
everything fitted into place. His 
problem was not QL-2-PC 
Transfer but the menu_rext 
extensions. 


The client had bought a se- 
cond hand QL system plus 
additional software, which had 
included the menu_rext exten- 
sions and QL-2-PC_ Transfer. 
The trader had installed the 
software for the client, but the 
latter had not fully understood 
what had been installed and 
how the two programs worked 
together The menu_rext ex- 
tensions are user-friendly and 
intuitive to use if you know 
what their purpose is, but if 
you are not expecting them it 
is easy to become confused. | 
was able to give the client a 
quick tutorial over the tele- 
phone and could hear his 
gasps of pleasure as he rea- 
lised the versatility of the ex- 
tensions. 


Not all QL users are computer 
experts. We traders still come 
across the occasional black 
box and Trump Card user. 
Other users, with more ad- 
vanced systems, are more in- 


terested in using the QL for 
word processing or simple 
business use than in gaining a 
deep technical knowledge. Yet 
other users have bought QPC 
hoping to gain the best of both 
the QL and PC worlds, but 
have found the program diffi 
cult to use. 


Those of us whose main QL’ 
is now QPC may find this hard 
to believe, but if you think 
about it is quite logical. Indeed 
as QPC has improved for us in 
its versatility and sophistica- 
tion, it has become more diffi- 
cult for some people. Try ex- 
plaining in simple terms to a 
person who is not fully com- 
puter literate the difference 
between wini_ and dost-. It is 
not as easy as you might think. 
Both use the PC’s hard disk, so 
why do we need both? 


Even the concept of an emula- 
tor can be difficult for some 
people to understand. You tell 
them that when QPC is run- 
ning, the PC is no longer a PC, 
but a QL, but you can stil 
Switch between QL and PC 
programs and save and load 
from the PC's hard disk. You 
talk about QPC being a Win- 
dows program, but how can it 
then be a QL? And if it's a 
Windows program, — why 
doesnt it work with every 
printer as other Windows pro- 
grams do? Even some skilled 
QL users have difficulty in un- 
derstanding and explaining 
that. 


Disks are another big problem. 
Most of us in the QL world 
grew up with DD disks and 
then upgraded to HD and even 
ED. We are far more know- 
ledgeable about disks than 
most PC users. Even so we 
can still get into some terrible 
muddles, and disks are one of 
the greatest areas of difficulty 
for QL-2-PC Transfer users. 
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Sometimes it is difficult to de- 
termine just what the disk pro- 
blems are. 


First of all there is the diffe- 
rence between a PC formatted 
disk and a QL formatted disk. 
Jo complicate matters further 
some of the older QL pro- 
grams for writing to PC for- 
matted disks only handle DD 
disks. Then there is the for- 
matting difference between a 
QL word processing file and a 
PC word processing file. And 
the really nasty snake in the 
grass is the pre-gold card QL 
system that formats HD disks 
as DD so that PC's are unable 
to read them. 


If you think disk problems are 
only for the ignorant, there is 
one that has caught out seve- 
ral QL experts. Use QL-2-PC 
Transfer with QPC installed on 
a Windows98 PC and transfer 
a file to a PC formatted disk. 
Tap ALT + TAB to return to Win- 
dows and look at the contents 
of the disk. Now go back to 
QPC and transfer a second file. 
Use ALT + TAB to check the di- 
rectory and this second file will 
not be in it. It is on the disk, but 
because of some form of disk 
caching, Windows98 does not 
see It. 


Helping people with problems 
has taken on a new dimension 
in the last 18 months or so, as | 
have been increasingly asked 
about recovering information 
from the files of QL users who 
have died. (A Google search 
for "QL PC Transfers’ quickly 
brings people in contact with 
me) Sometimes these calls 
come from family and some- 
times from a club or society 
who need to access their old 
records. 


Some of these people have 
never used a QL and ! cannot 
ask if it is a QDOS, Minerva or 
an SMSQ system. More often 
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than not I have to ask what the 
QL looks like to determine 
whether it is an original black 
box or a more up to date sys- 
tem. | then have to judge whe- 
ther | can teach them to use 
the ver$ command. | cannot 
ask about the pointer environ- 
ment, but ask instead if they 
have found any of the former 
user's software. This gives me 
some idea of his level of QL 
use. It is only after | have ans- 
wers to these questions and 
have formed an assessment of 
the callers own computer 
skills that | can start to advise 
on the best method of recover- 
ing files. Some of the callers 
have never used a DD disk, 
and have always used 
Windows. MS-DOS com: 
mands, switches and parame- 
ters are a world they have 
never experienced. Hence the 
anger and frustration of the 
Windows user when he was 
told to use qltools. "| am not a 
Linux/QL specialist.” 


The Linux experts in our midst 
have made a great contribution 
to the QL, especially in porting 
programs from the PC. Hope- 
fully they will also write the 
filters that will enable us to use 
practically any printer with 
QPC. But their weakness is the 
lack of user friendliness in their 
programs, with the result that 
much of their work has re- 
mained outside mainstream QL 
use. | have the impression 
some Linux experts believe 
that pure programming means 
programs must be started with 
complicated commands and 
switches. Computing has 
moved on since those days. It 
is an unpleasant message for 
QLers to hear but there are 
many things we can learn from 
Bill Gates. 


One of the reasons QPC has 
become such a popular pro- 
gram is because Marcel Kilgus 


has made it user-friendly. He 
has listened patiently to many 
comments, serious and _ silly, 
professional and amateur, prac- 
tical and impractical and used 
this information to continually 
improve the program. We 
should all try to follow this 
example to gain more under- 
standing of users who are not 
as computer literate as we are. 
Indeed this is an urgent priority 
because | fear we are losing 
our ability to communicate with 
many people on the periphe- 
rals of the QL community. 


| do not wish to criticise the 
editors of QL Today, who are 
dependent on the copy they 
receive, but | have the distinct 
impression the content of the 
magazine has become more 
technical in the last 18 months 
or so. This is inevitable given 
the developments in SMSQ/E 
especially now the colour dri- 
vers are no longer a new toy, 
but are beginning to be used in 
programs. But are we in 
danger of becoming a 
magazine for the few? What 
does the less skilled user have 
on the content of QL Today? 


Or take a look at QL shows. 
Apart from North America, 
when was the last time there 
was a formal demonstration of 
a new product or a talk at a QL 
workshop? Where are all the 
people who used to bring their 
own QL's and ask for advice 
or give advice to others? 
Bluntly, what has the less 
Skilled QL user to gain from 
attendance at our present 
style of workshop? 


Unless we are careful the QL 
community will become a 
smaller and smaller group of 
more elite but more inward 
looking people. And one day 
we Shall finally disappear up 
our own |/O ports. 


QL loday 


SAW POINTS @FFEUTS ANE 


The Guardian Newspaper's 
Online section often has little 
things of interest to me in it and 
every now and then one of 
them makes its way into this 
column. | noticed, the other day, 
that the Museum of Computing 
at the Oakfield Campus of the 
University of Bath in Swindon is 
hosting a History of Home 
Computing Exhibition. | do not 
know how long this will run for 
but you can check this out at 
www.digitalhistory.org.uk Star of 
the show is, apparently, the 
‘1978 Science of Cambridge 
Mark 14’ which had a massive 
256 bytes of RAM. It was de- 
signed by none other than Sir 
Clive himself and was, accor- 
ding to them, the thing which 
set him on the path to the 
Spectrum and to the QL. If you 
are in the area that may be a 
good place to visit. 


And What Do You Use 


Yours For? 

One other thing which inter- 
ested me in the same edition of 
the paper was an article about 
active web use. This is a pro- 
cess where people do not ac- 
tually go to websites and look 
for the information. They use 
another program to extract that 
information for them via an Ap- 
plication Programming _ Inter- 
face. Now, that Interface is not 
platform specific. It is, in fact, a 
series of defined ways to com- 
municate with engines that 
exist on the web. This already 
exists in the form of ‘Google 
Alerts’ (www.googlealert.com) and 
in some other areas. 

The reason for this long pre- 
amble here is that this would 
make the web accessible to 


QL loday 


QDOS/SMSQ_ users without 
the use of an internet browser. 
lf someone interpreted these 
APIs so they can be used from 
a QDOS/SMSQ system we 
would be able to extract data 
from the web. At the moment 
there are no real standards for 
these interfaces but the frame- 
work is being built and should 
be looked into. 


ReQLaim the Future 
There has been a lot of talk on 
the glusers internet group 
about ways to revitalise the QL 
Community. Tarquin Mills started 
this off by suggesting that 
there should be a Workshop in 
Norwich and Geoff Wicks ad- 
ded comments about the way 
that shows today differed from 
those of a few years back. 
Many of Geoff's comments 
rang very true. When | was 
organising this year's Hove 
show, for instance, | spent a 
while trying to decide if | could 
have some talks and other ses- 
sions on the day but | honestly 
could not think of anyone who 
might have something to talk 
about. Back in the days when | 
arranged my first show we 
were pushed to fit in all the 
people who wanted to do 
something. 

| suppose that this is a sign of 
the times. There are fewer new 
developments to put before 
the people these days and that 
is a bald fact. | feel that the 
coming year could see some 
change to that situation. Al 
ready we have the colours for 
the Window Manager and the 
release of the first versions of 
SMSQ/E with changes brought 
in by the users. QDT is very 


much at the starting gate and 
the version that Jim sent me 
just before the US show looks 
like it will be a very interesting 
development. Nasta is still talk- 
ing in a positive way about his 
future plans for hardware and, 
more importantly the reader- 
ship of this magazine has 
stayed steady through the 
current bout of renewals. 
There will be changes over the 
next 12 months and there is 
room for some optimism about 
the direction we are inching our 
way along. We do need to revi- 
talise the community and get 
some more contribution and 
participation but we also need 
more products and develop- 
ment. 

| have just heard that the Quan- 
ta AGM next year will be held in 
Manchester and that it will be a 
two day event celebrating the 
QL's 20th Birthday. This seems 
like an excellent start to the 
process so it would be very 
nice if we could get a large 
number of QL Users along to it 
There may be some more 
details in this magazine but, if 
not, you will find them in the 
next issue of Quanta. 


Quomunity Spirit 

One thing that Geoff men- 
tioned about the state of QL 
shows Is the fact that these are 
now more social events than 
trade shows. That is very true. 
It is a place to meet old friends 
and chat. It is, therefore slightly 
saddening that many of the 
shows have lost that overnight 
section. The first shows | atten- 
ded as a trader nearly always 
involved an overnight stay in a 
hotel somewhere. This also 
was often accompanied by a 
meal and session at the bar at 
which many QL stories, issues 
and ideas were discussed. In 
fact it was in some of these 
bars that many QL legends 
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grew too, (including the memo- 
rable time in Ireland when Stu- 
art Honeyball had spent most 
of the afternoon drinking. We 
met him coming out of the bar 
as we were all walking to it 
after packing the show up. He 
went back in and carried on 
drinking until closing time. He 
then went out, got onto his 
bike, and fell into a ditch!) This 
kind of shared experience is 
something we are now missing 
and something which | would 
like to see revived. 

We are a diverse community 
with a single point of contact 
but a lot in common so we 
should exploit that sense of 
community and use it to make 
us stronger. 


True Colours...... 

Over the past few columns | 
have waxed lyrical about the 
new colours available to users 
of SMSQ/E and the new Win- 
dow manager. It is no surprise, 
then, that most of you have 
been very interested in getting 
to grips with the new system. 
There have been a few hold 
ups and glitches in getting 
them out to to the public so, for 
most of this time, there have 
been few people who could 
actually try them out. | hope 
that this situation is now 
coming to an end. 

Part of the problem in getting 
these releases out to the users 
has been with the problem of 
what to do for those people 
who do not have a system that 
is capable of displaying the co- 
lours. Jochen was determined 
that these people would not 
lose out when the programs 
get updated. If we had just 
released programs like QD, 
QSpread etc. for use on the 
new system anyone with a 
Standard QL would not have 
been able to use them be- 
cause their system would not 
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be able to handle the sprites 
and colour definitions. This may 
not be too much of a problem 
in itself because they could go 
on using the older version but 
it would mean that these users 
would have been shut out of 
any new features that were 
added to programs converted 
to use the new colour 
schemes. It would also mean 
that any new customers would 
be limited to those who had the 
latest versions of SMSQ/E. 
Maintaining two versions of 
programs was not an option 
that would be easy to handle 
and, as the changes grew, the 
two programs would become 
harder and harder to keep in 
line. 

It is this that has prompted 
Wolfgang Lenerz and Marcel 
Kilgus to get the new 
PTR_GEN and WMAN together 
for use on non SMSQ/E sys- 
tems. This does not mean that 
these systems will now be able 
to display the colour palette 
that SMSQ/E does but it does 
mean that they will be able to 
read and use the programs 
designed for the new system. | 
do not know who did the most 
work on this (but | can make a 
good guess) so | cannot offer 
any personal accolades but 
well done anyway. 

While | am on the subject of 
colour displays there is one 
subject that may be misleading 
some people. The colour dis- 
plays will only work if the hard- 
ware support is there. This 
means that you can run the 
new version of SMSQ/E for the 
Gold Card with Marcel’s Colour 
Drivers on a standard QL with a 
Gold Card but you will not see 
the colours. In order to do this 
you will have to use an Aurora. 
Six years after its release the 
Aurora will finally be able to 
display the colours it was de- 
signed to use. 


| had to go to the shelf to 
check out when the Aurora 
was released (It was mentioned 
in Vol i iss 6 of this magazine 
that it was due for release} | 
noticed that, in the same ad- 
vert, Qubbesoft were announ- 
cing the Super-Duper Gold 
Card. This is another project 
which has been under wraps 
for far too long now. It is perti- 
nent to mention this at this 
point because one of the big 
drawbacks in the use of exten- 
ded colours on the standard 
Aurora based system is the 
amount of memory they need 
to run at large resolutions. This 
is really where QPC 2 and the 
Q40/Q60 comes into its own. 
Again the Q40 was a project 
that was essentially linked with 
these colour drivers and gave 
Tony the final nudge to start 
their creation. 

In order to draw the screen 
with a larger colour palette the 
system does need to have a lot 
more RAM under its belt. May- 
be we could find some way for 
Quanta to support Nasta in the 
development of the Super Gold 
Card replacement. Not a bad 
idea for a 20th birthday year. 


.... Hidden Depths.... 

It was while | was playing with 
these new additions — to 
SMSQ/E that | noticed a couple 
of things that need to be 
brought to the attention of the 
QPC 2 using public. | have men- 
tioned before that the settings 
for QPC2 can be configured 
and saved/restored by using 
Menuconfig. It was only when | 
was looking at these configu- 
rable items that | saw some of 
the changes ~- and these are 
changes you will not be able to 
get to any other way. 


OK so here is a quick tutorial. 
First you must have a version of 
QPC2 that has access to the 
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DOS device. If you are upgra- 
ding from an earlier version 
that has no DOS device sup- 
port you will have to run QPC2 
unmodified to be able to confi- 
gure it this way. Basic configu- 
ration can be done from the 
window that appears when you 
start QPC2 (If you have sup- 
pressed this don't forget you 
can see it by holding down the 
shift key when starting the pro- 
gram). You can set the drives, 
memory, printer and colours 
from there. | wrote a thorough 
article on this in the last volume 
of QL Today (vol 7 iss 3 in fact). 
Once you have QPC2 running 
start Menuconfig and navigate 
to the DOS hard drive partition 
where you have _ installed 
QPC2. Now the fun begins. 
When you have located the 
QPC2 folder you should click 
on ‘'SMSQE.BIN and choose 
‘configure’. There are eight se- 
parate configurable items here. 
0. Generic Settings - This 
holds many of the items you 
can set in the startup win- 
dow such as memory etc. It 
also holds the setting for the 
Sound Device which is not 
configurable anywhere else. 
1. Display Settings - this is 
the window size, display co- 
lours etc. Most of this is best 
set up with the startup win- 
dow. 
2. WIN/FLP Settings - This 
is the location and name of 
the various QXLWIN files 
which will become the WINI_ 
to WIN8_ drives when the 
emulator is running. Just as 
easy to set this up from the 
startup window. 
3. DOS device Settings - 
This is the list of locations 
and partitions which will be- 
come the DOSi_ to DOS8_ 
devices when the emulator is 
running. This is also just as 
easy to set up from the 
Startup window. 
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4. SER Settings - list of the 
serial devices and their equi- 
valents on the PC side. 
5. PAR Settings - list of the 
printer or parallel ports - 
best set with the startup win- 
dow. 
6. WMAN - now we get to 
the interesting bit! This has 
only one setting which is 
‘Move Window Operation’ 
and three choices ‘Outline’, 
‘Window’ and ‘Sprite’ 
SPRITE The current default 
setting for all QL programs 
is ‘Sprite’ and that is the 
one you are familiar with. 
When you click on the 
‘Move’ icon a ‘double-box’ 
sprite appears and you can 
move the program around 
the screen. A second click 
will reposition and redraw 
the program's window. 
OUTLINE This is a new 
setting and clicking on the 
Move Icon will draw an Out- 
line of the program's win- 
dow and move that around 
the screen. A second click 
will again reposition it and 
redraw it. 
WINDOW This is another 
new setting and the me- 
thod here is different. If you 
click on the Move Icon and 
hold the left mouse button 
down you can move the 
whole window around the 
screen. 
These three WMAN op- 
tions are available in all fla- 
vours of SMSQ/E v 3.01 for 
all platforms and are not 
confined to QPC2. 
7. WMAN System Colours - 
As the name suggests this is 
a list of the colour settings 
for SMSQ/E not an easy file 
to edit unless you know the 
values of the colours you 
want. (More on this later) 
8. HOTkey System Il - This 
has the settings for the stuf- 
fer buffer etc. These settings 


are not available anywhere 
else. 


Once you have set up your 
system you can save it back 
with the new settings in the 
normal way. When you exit 
Menuconfig it will invite you to 
update the 'menuconfig_inf file. 
lf you do this, the next time you 
get an upgrade to a new ver- 
sion of QPC2 all you need to 
do is to run Menuconfig again 
and tell it to Update the set- 
tings from the 'menuconfig_inf’ 
file. The new version should 
then be set to the same setting 
as the previous one. 

Menucontig does have the op- 
tion to learn the current set- 
tings and save them to the 
’menuconfig_inf’ file so maybe 
that is something you should 
do with your current version 
before installing your upgrade. 


... and Deeper Meanings 
One of the other things that | 
have mentioned in this column 
before is the way that you can- 
not tell which of the DOS devi- 
ces you have started from in 
QPC2. This has been a pro- 
blem, especially when | forgot 
to go through the procedure | 
have just describe when up- 
grading to a new copy of 
QPC2 (| usually get a few beta 
test versions from Marcel so it 
gets changed a lot here). 
Therefore when | wanted to go 
to the DOS device which is a 
folder | set up to hold QL files 
downloaded or emailed to me | 
was sometimes not in the right 
folder and found it hard to work 
out where | was. 

We discussed all of this while 
on the long journey to the 
rollercoaster park on the recent 
US trio and QPC2 and QPAC 2 
now work together to give the 
directory that you started from 
in the top, right hand, area of 
QPAC 2's display. You will need 
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QPC2 v 3.141 and QPAC2 v 1.42 
to get this feature but it is very 
useful so thank you Marcel. 
Another great improvement in 
the latest version of QPAC2 is 
the change in the way it 
displays the size of the drive. 
No longer is it displayed in sec- 
tors. The current version cor- 
rectly converts the display to 
read Kilobytes, Megabytes or 
Gigabytes depending on the 
size of the drive involved. Much 
easier to understand. | wonder 
when we will see the first 
Terrabyte QXLWin file? 


More On Colours and 
Upgrades. 


It seems that most of the co- 
lumn this month is taken over 
by the recent changes to 
SMSQ/E and QPC 2 but that 
should please Per Witte at 
least because he was complai- 
ning on the QL users list that 
very little mention was made 
on these great advances. | 
think that part of the reason for 
this is that there are very few 
people out there who had 
managed to get their hands on 
them, and this is why... 

The problem was that, when 
the new versions of SMSQ/E 
were ready to hit the street it 
suddenly occurred to people 
that they had put no real work 
into the way that the colours 
could be edited or set. As | said 
in the section of configuration, 
the colour setting are all there 
in the configuration block but 
making any meaningful chan- 
ges to the system is difficult 
and frustrating. 

The colours are set up in the 
config block with a value be- 
side each component. That 
number signifies what colour 
each of those components wil 
be displayed as. the trouble 
here is that | cannot figure out 
what the palette is that the 
numbers use. All attempts to 
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change these numbers ran- 
domly seemed to end up with 
stipples which was not what | 
wanted at all. Marcel did prov- 
ide a ‘dirty’ way to change the 
colours and this was to poke 
the values into the system with 
a set of small BASIC file. He 
sent me four different colour 
schemes each Set up in one of 
these BASIC files and the 
colour changes take effect 
when each one is run. | did 
manage to write a small menu 
driven program to activate the 
colour schemes and, because 
it is written using the menu 
extensions the new colours are 
displayed in the menu itself 
when it is redrawn after exe- 
cuting the BASIC file. 

The other reason that we have 
not, so far released the files to 
the public is because we have 
not, so far produced a good 
way for the general user to edit 
his colour schemes. There 
were a lot of discussions about 
how to do this and, in the end, | 
nominated Wolfgang Uhlig to 
be asked to try to write a 
program to do this. He has 
gamefully accepted the chal 
lenge and | look forward to 
seeing the end result. His work 
with the colour selection tool 
for BASIC was very good but 
he does have a serious lear- 
ning curve to get to grips with 
a different palette. | look for- 
ward to awarding the next 
Honourable mention to him 


And talking of that...... 


Finally, a brief word on the other 
versions of SMSQ/E available 


and the distribution of the 
award for this issue. 

| no longer have a QXL card 
available here to test v3.01 on 
(nor do | have a PC with the 
requisite slot to plug it into - 
the ISA bus has vanished into 
the land of the fossils). | must 
also confess that | have, so far, 
not had time to get the MinisQL 
up and running but | do have 
Joachim's Q40 and | ran it on 
that. 

| must give the people who 
made the changes to SMSQ/E 
for this platform full marks. The 
current version fixes many of 
the niggling little problems | had 
with Q40 over the pre v3 ver- 
sions. DD disks now format and 
read properly, ProWesS runs 
correctly and does not lock up, 
and the soft reset works again. 
| had been stuck on version 
2.97 of SMSQ/E for the Q 40 
for some time because it was 
the last consistent version | 
was able to use and even that 
one would not format or write 
to DD disks with any consisten- 
cy. | can say that, so far v3.01 
has proved to be very good. All 
of the hard words and heart 
rending about how SMSQ/E 
should be handled when Tony 
Tebby handed over the reins 
have been worthwhile if the 
code that gets into the hands 
of the public is of this quality, 

It may take a little longer than it 
used to, to get the releases on 
the streets but if the result is 
trouble free running for the 
user it is worth the wait 

| handed out the award to the 
authors of the colour drivers in 
the last issue but this award 
must go to Wolfgang Lenerz 
and the team of Beta testers 
and contributors who have 
made this system work. Wolf- 
gang has upheld the standards 
we asked of him when he took 
on the task of registrar and we 
have all benefited from his 
diligence. 
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The QL Show Details 


Isn’t it amazing? Lots of shows coming up this autumn this year all around Europe!? 


As | can’t squeeze all the show-related information on the next page, here are some more details: 


Especially for Berchtesgaden, | suggest you go back one and two volumes of QL Today, where 
Friedemann Oertel (the show organizer) made the effort to give very detailed ideas about what else 
to do while in the great area of Berchtesgaden! 


More details on the Irish Show weekend 
The venue: The Wicklow Web Centre, Main Street, Roundwood, Co Wicklow, Ireland. 
The "show" will take place on the Saturday 30th August 2003 - from 1pm to 4pm, However, it is 
never really a show as such, more a casual get together of QL users with the traders attending. so If 
you do intend to come, and are looking for something specific from any of the traders, do contact 
them directly and order it, as many of the traders coming will be travelling light - very light! If you 
don't pre-order, they may not have what you need on the day. Roy Wood of Qbranch, Tony Firshman 
of TF Services, and Darren Branagh of Q-Celt Computing will be there. Steve Reyal will hopefully be 
on hand to demo the QL2002 DVD - and a full screening will take place for anyone interested, free 
of charge. There may even be a demo of the new QL software product, LAUNCHPAD, by Dilwyn 
Jones!! 
Roundwood is a beautiful small village high in the Wicklow Mountains, about 35 miles south of Dublin 
City. It is about an hour and 15 minutes drive or so from the Dublin airport, and 40 minutes drive from 
the Dun Laoghaire ferry terminal (where the HSS ferry docks from Holyhead) Rosslare europort is 
about a 2 hour car journey. Roundwood is the highest village in Ireland, and contains several high 
quality pubs and restaurants - just ask anyone who was here last year!! Glendalough (the 2nd 
biggest tourist attraction in Ireland) is only a few miles away. There are scenic drives, championship 
golf courses, fun parks, and nature reserves all nearby. The "Show” venue is the Wicklow Web 
Centre, a business located half way up the Roundwood main Street, on the right, if approaching from 
the Dublin direction - it is a bright yellow painted building, and has ample car parking at the rear. Full 
internet and Email access is available free of charge inside on the day of the “show”. Tea and Coffee 
facilities are also available. 
Anyone with any further queries, or for directions or accomodation, should contact Darren Branagh 
on 00-353-404-45319 or mobile 00-353-86-8100090, or email darren.branagh@boimail.com (office 
hours only). 


More details regarding Berchtesgaden for this year’s event: 


The show will take place in "Hotel Schwabenwirt” (same venue as 2001, opposite to the main station 
in the centre of Berchtesgaden. Last year's venue was "Tauernhof”). 

Address info: Hotel Schwabenwirt, Konigsseer Str. 1, 83471 Berchtesgaden, GERMANY 

Tel. +49-8652-2022, Fax +49-8652-1706 


A room has been reserved from Friday evening until Sunday morning, so computers can be brought, 
built up and locked at night in this room (again, like two years ago). 


Davide Santachiara, who is organising the Italian QL Show again, informed us: 


This week | asked the permission for the meeting room at the usual place and, even if | will have the 
official OK only next month, it's fundamentally 99% confirmed. 

The place is: 

Sala Congressi Circoscrizione, 2 Via Fratelli Cervi, 70 Pieve Modolena, Reggio Emilia, ITALY 

You can find the map at 

http://www.geocities.com/dsantachiara/mappameetingeng htm 

some round-abouts have been added instead of cross-roads but the way is the same. 

| really hope to see you again next October. 


) The QL Show Agenda ¢ 


3rd Irish OL Show Weekend - (Ireland 


Weekend, 29th of August to 31st of August 
All details on reverse side! 


OL Meeting - (D) Berchtesgaden 


Saturday, 4th of October, 10:00 to 17:00 
Hotel Schwabenwirt, Konigsseer Str. 1 
Same venue as in 2001! 

Details on the reverse side! 


OL Meeting - (NL) Eindhoven 
Saturday, 11th of October, 10:00 to 16:00 ‘ 
Pleincollege St. Joris, Roostenlaan 296 d 


OL Meeting - (I) Reggio Emilia 
Sunday, 26th of October, 10:00 to 16:00 : 
Sala Congressi Circoscrizione 2 - Via Fratelli Cervi 97| 
Same venue as the years before! : 


Details on the reverse side! } 


OL Meeting - (GB) Byfleet 


Sunday, 9th of November, 10:00 to 16:00 
Byfleet Village Hall 


Same venue as all the years before! : 
Details in previous and next issue! ) 


